← Alle Funktionen

REST-API — erstellen und verwalten Sie Ihre QR-Codes aus Ihren Tools

Verbinden Sie Ihr CRM, Ihr Automatisierungstool oder Ihre Skripte mit QR Suisse: Erstellen, bearbeiten und löschen Sie dynamische QR-Codes und lesen Sie ihre Statistiken über die API. Pläne Pro und Entreprise.

Pro · Entreprise

Mit der REST-API von QR Suisse können Ihre Tools QR-Codes vom Typ Link oder Visitenkarte erstellen, lesen, bearbeiten und löschen, ihr Bild als PNG oder SVG herunterladen und ihre Scan-Statistiken lesen. Ihre Tools können zudem einen QR-Code archivieren und reaktivieren, die Liste durchsuchen und filtern, das verbleibende Erstellungskontingent abrufen und eine Erstellung mit dem Header Idempotency-Key ohne Duplikat erneut senden. Sie lässt sich aus jedem Tool aufrufen, das eine HTTPS-Anfrage senden kann: einem CRM, einem internen Skript oder einem Automatisierungstool wie Zapier oder Make. Jeder API-Schlüssel erhält nur die nötigen Rechte (Lesen, Erstellen, Bearbeiten, Löschen, Statistiken); er wird nur einmal angezeigt und kann danach jederzeit rotiert oder widerrufen werden, solange Ihr Konto im Plan Pro oder Entreprise ist. Der Plan Pro umfasst 5 Erstellungen von QR-Codes über die API pro Kalendermonat und 1 aktiven Schlüssel; der Plan Entreprise 100 Erstellungen pro Kalendermonat und bis zu 10 gleichzeitig aktive Schlüssel. Nur diese Erstellungen werden angerechnet: Einen QR-Code lesen, bearbeiten oder löschen oder ihn im Dashboard erstellen wird nicht angerechnet. Optional sind Erstellungspakete erhältlich, sofern ein bezahltes Abonnement aktiv ist (siehe Preise). Der Gratis-Plan bietet keinen Zugang zur API. Die API-Dokumentation beschreibt jeden Endpunkt und bietet die OpenAPI-Spezifikation an.

Bildschirm der API-Schlüssel in QR Suisse: ein Schlüssel mit seinen Rechten, dem Datum seiner letzten Verwendung und dem Erstellungskontingent des Monats — Demo-Konto, fiktive Daten.
Schlüssel mit begrenzten Rechten, jederzeit rotierbar oder widerrufbar (Demo-Konto, Pro-Plan).

Häufig gestellte Fragen

Welche Pläne bieten Zugang zur API?
Die Pläne Pro und Entreprise. Der Plan Pro umfasst 5 Erstellungen von QR-Codes über die API pro Kalendermonat und 1 aktiven Schlüssel. Der Plan Entreprise umfasst 100 Erstellungen pro Kalendermonat, mit bis zu 10 gleichzeitig aktiven Schlüsseln. Der Gratis-Plan bietet keinen Zugang zur API.
Was wird auf das Kontingent angerechnet?
Nur das Erstellen von QR-Codes über die API. Einen QR-Code lesen, bearbeiten, archivieren, reaktivieren, löschen, sein Bild herunterladen oder seine Statistiken lesen wird nicht angerechnet, ebenso wenig ein im Dashboard erstellter QR-Code. Eine Erstellung bleibt angerechnet, auch wenn der QR-Code danach gelöscht wird. Das Kontingent wird am 1. jedes Monats um 00:00 Uhr UTC zurückgesetzt (01:00 oder 02:00 Uhr in der Schweiz), ohne Übertrag.
Wo sehe ich die in diesem Monat genutzten Erstellungen?
Im Bildschirm API-Schlüssel des Dashboards, der Mitgliedern mit der Berechtigung «Verwalter der API-Schlüssel» (oder Administrator) zugänglich ist. Der Bereich «QR-Code-Erstellungen über die API in diesem Monat» zeigt die bereits genutzten enthaltenen Erstellungen, die aus Ihren Paketen genommenen Erstellungen und die in Ihren Paketen verbleibenden Erstellungen sowie das Datum, an dem das Kontingent zurückgesetzt wird. Über die API liefert GET /usage dieselben Zahlen an einen Schlüssel mit dem Recht QR_CREATE.
Was passiert, wenn das Kontingent aufgebraucht ist?
Die Erstellungen verbrauchen Ihre Erstellungspakete, falls Sie noch welche haben. Andernfalls wird die Erstellung abgelehnt (Fehler 429 quota_exceeded), bis zur Zurücksetzung am 1. des Folgemonats oder bis zum Kauf eines Pakets. Es wird nichts nach Verbrauch abgerechnet.
Kann ich einen QR-Code über die API archivieren oder reaktivieren?
Ja, ein QR-Code nach dem anderen: Eine Bearbeitung mit active auf false archiviert ihn, mit true wird er reaktiviert. Das wird nicht an das Erstellungskontingent angerechnet. Beim Archivieren bleiben Inhalt und Statistiken erhalten. Das endgültige Löschen hingegen ist unwiderruflich: Der QR-Code und seine Statistiken werden gelöscht, und seine Adresse kann nie wieder verwendet werden.
Unterstützt die API Etiketten, Gruppenaktionen und Exporte?
Nein. Etiketten, Mehrfachauswahl, ZIP-Download und CSV-Export erfolgen im Dashboard, mit den Plänen Pro und Entreprise. Über die API lesen Sie die Liste Ihrer QR-Codes Seite für Seite, mit Suche (Bezeichnung, Ziel und Ende der kurzen Adresse), Filtern (Status, Typ, Erstellungszeitraum) und Sortierung, aber ohne Filter nach Etiketten, und laden die Bilder einzeln herunter.
Was erledige ich im Dashboard statt über die API?
Die Einrichtung des Kontos: API-Schlüssel erstellen und verwalten, Mitglieder einladen und ihre Berechtigungen festlegen, die eigene Domain einrichten, das Abonnement verwalten und Erstellungspakete kaufen. Die API-Dokumentation vergleicht im Detail, was die API und was das Dashboard kann.
Kann ich die API mit Zapier, Make oder einem KI-Agenten verbinden?
Ja, mit jedem Tool, das HTTPS-Anfragen mit einem Schlüssel senden kann. Es gibt derzeit weder eine offizielle Integration noch einen eigenen Konnektor für KI-Assistenten (MCP). Die Voreinstellung «KI-Assistent» beschränkt den Schlüssel auf Lesezugriff.
Wie schütze ich einen API-Schlüssel?
Geben Sie ihm nur die nötigen Rechte, rufen Sie die API immer über https:// auf und bewahren Sie den Schlüssel in einem Geheimnis-Manager auf: Er wird nur einmal angezeigt. Wurde er möglicherweise offengelegt, rotieren oder widerrufen Sie ihn auf dem Bildschirm API-Schlüssel. Im Gratis-Plan, in dem Ihre Schlüssel eingefroren sind und nicht angezeigt werden, schreiben Sie von der E-Mail-Adresse eines Administrators des Kontos an contact@qrsuisse.ch.
Gibt es eine Begrenzung der Anzahl Aufrufe?
Ja, zum Schutz des Dienstes: 30 Anfragen pro Minute und Schlüssel, davon höchstens 8 Erstellungen. PNG-Bilder sind zudem auf 10 pro Minute für das ganze Konto begrenzt. Darüber hinaus antwortet die API mit 429 rate_limited und der Wartezeit. Nur die Erstellung unterliegt zusätzlich dem monatlichen Erstellungskontingent.
Eine Erstellung wurde durch einen Netzwerkunterbruch unterbrochen: Wie sende ich sie ohne Duplikat erneut?
Senden Sie jede Erstellung mit dem Header Idempotency-Key: ein neuer Zufallswert pro Erstellung (UUID v4 empfohlen), ohne Personendaten. Kommt die Antwort nicht an, senden Sie dieselbe Anfrage mit demselben Wert innerhalb von 24 Stunden erneut: Sie erhalten den bereits erstellten QR-Code, ohne zweiten QR-Code und ohne zweite Erstellung, die vom Kontingent abgezogen wird. Ohne diesen Header prüfen Sie die Liste Ihrer QR-Codes, bevor Sie die Anfrage erneut senden: Eine erfolgreiche Erstellung bleibt angerechnet, auch wenn Sie das Duplikat danach löschen.

Hilfeseiten

QR Suisse testen

Der Gratis-Plan steht sofort im Self-Service zur Verfügung, ohne Kreditkarte.

Kostenloses Konto erstellenPro-Plan entdecken