API-Zugang

QR-Codes anlegen und auswerten aus Ihren eigenen Systemen.

Anmelden

Der API-Zugang gehört zu den Tarifen Business und Agentur.

Den Schlüssel legen Sie später selbst in Ihrem Konto an — er wird sofort erzeugt, ohne Freischaltung und ohne Wartezeit. Was die Schnittstelle kann, steht vollständig auf dieser Seite, damit Sie vor der Entscheidung prüfen können, ob sie zu Ihren Systemen passt.

Tarife ansehen Konto anlegen oder anmelden

So funktioniert der Zugang

Der Schlüssel wird als Kopfzeile mitgeschickt. Beide Schreibweisen funktionieren:

X-API-Key: qrova_ihr_schluessel
Authorization: Bearer qrova_ihr_schluessel

Basisadresse: https://qrova.io/wp-json/dqm/v1

Endpunkte

Methode	Pfad	Zweck
GET	`/qr`	Alle QR-Codes auflisten
POST	`/qr`	QR-Code anlegen
GET	`/qr/{id}`	Einzelnen Code lesen
PATCH	`/qr/{id}`	Ziel oder Name ändern
DELETE	`/qr/{id}`	Code löschen
GET	`/qr/{id}/download`	Bilddatei abrufen
GET	`/analytics/stats`	Kennzahlen
GET	`/analytics/chart`	Verlauf über die Zeit
GET	`/analytics/breakdown`	Aufteilung nach Gerät, Land, Stadt
GET	`/analytics/export`	Scan-Daten als CSV

Beispiel: Code anlegen

curl -X POST https://qrova.io/wp-json/dqm/v1/qr \
  -H "X-API-Key: qrova_ihr_schluessel" \
  -H "Content-Type: application/json" \
  -d '{"name":"Flyer Frühjahr","target_url":"https://ihre-seite.de/aktion"}'

Beispiel: Ziel später ändern

curl -X PATCH https://qrova.io/wp-json/dqm/v1/qr/123 \
  -H "X-API-Key: qrova_ihr_schluessel" \
  -H "Content-Type: application/json" \
  -d '{"target_url":"https://ihre-seite.de/neues-ziel"}'

Grenzen und Regeln

120 Anfragen pro Minute je Schlüssel. Darüber antwortet der Server mit Status 429.
Höchstens fünf aktive Schlüssel je Konto.
Die Zahl der QR-Codes und Scans richtet sich nach Ihrem Tarif — über die API gelten dieselben Grenzen wie im Konto.
Der Schlüssel reicht nur an QR-Codes und Auswertung. Buchhaltung, Rechnungen und Kontoeinstellungen sind für ihn gesperrt, auch wenn Sie im Konto Zugriff darauf haben.
Verbindungen ausschließlich über HTTPS.

Zum Schlüssel selbst: Wir speichern ihn nur als Prüfsumme, nicht im Klartext. Nach dem Anlegen sehen Sie ihn genau einmal — danach nie wieder. Geht er verloren, widerrufen Sie ihn und legen einen neuen an. Legen Sie ihn nicht in ein öffentliches Repository und nicht in Frontend-Code: Wer ihn hat, kann Ihre Codes umleiten.

Fehlermeldungen

Status	Bedeutung
401	Schlüssel fehlt, ist falsch oder wurde widerrufen
403	Tarif ohne API-Zugang, oder Endpunkt für Schlüssel gesperrt
404	QR-Code nicht gefunden oder gehört einem anderen Konto
429	Zu viele Anfragen — eine Minute warten

Fragen zur Anbindung? Schreiben Sie an info@qrova.io — Antwort am selben Werktag.