Die QRbanner REST API v1 lässt Sie QR-Codes aus Scripts, Backends und CI-Pipelines erstellen, aktualisieren und organisieren. API-Keys sind im Free-Plan verfügbar — kein Sales-Call nötig.
API-Key erstellen
- Anmelden und Dashboard → Einstellungen → API Keys öffnen
- Key mit aussagekräftigem Namen erstellen (z. B. „Production backend“)
- Key einmal kopieren — er wird nur bei der Erstellung angezeigt
- Bei jeder Anfrage als Authorization: Bearer oder X-API-Key senden
Ersten QR-Code erstellen
POST /api/v1/qr mit einem JSON-Body aus name, category und qr_data. URL-Codes brauchen { "url": "https://..." }. Die Antwort enthält short_code und Scan-URL.
Scan-Webhooks empfangen
HTTPS-Endpoint unter Einstellungen → Scan Webhooks hinterlegen. Jeder Scan sendet per POST JSON mit event, qr_code_id und Scan-Metadaten. X-QRbanner-Signature mit HMAC-SHA256 und Ihrem Webhook-Secret verifizieren. Lieferhistorie im selben Panel einsehen.
OpenAPI-Spezifikation
openapi.json von /developers oder /api/openapi.json herunterladen und REST API v1 in Postman, Insomnia oder Ihr API-Gateway importieren — inkl. QR-, Ordner- und Webhook-Schemas.