QR-Code-API für Entwickler
API-Zugriff ist im Business- und Agency-Plan enthalten.
CRUD-Endpunkte für QR-Codes
Unter /api/v1/qrcodes listen Sie QR-Codes auf und legen neue an; unter /api/v1/qrcodes/:id rufen Sie einen einzelnen Code ab, aktualisieren oder löschen ihn. Eine Änderung von destination_url oder status per PATCH gilt ab dem nächsten Scan — der gedruckte Code bleibt unverändert.
API-Schlüssel mit festgelegten Berechtigungen
Erzeugen Sie API-Schlüssel im Dashboard mit genau den Berechtigungen, die sie benötigen — qrcodes:read, qrcodes:write, scans:read, conversions:write. Jeder Schlüssel ist auf 300 Anfragen pro Minute an die REST-API begrenzt, dazu separat auf 300 pro Minute für Conversions, und an einen Workspace gebunden; bewahren Sie ihn serverseitig auf.
Scan-Daten über die QR-Code-API
Blättern Sie unter /api/v1/scans seitenweise durch Scan-Ereignisse, gefiltert nach qr_id und einer Anzahl von Tagen: Gerät, Land, Referrer und Zeitstempel — dieselben datenschutzfreundlichen Daten wie in den Dashboard-Diagrammen, ganz ohne IP-Adressen im Klartext.
Conversion-API
Senden Sie Kauf- und Registrierungsereignisse per POST an /api/v1/conversions — mit einem event_name, einer external_id zur Deduplizierung, optional amount und currency sowie dem qr_slug, über den der Kunde kam —, um den Umsatz dem Scan zuzuordnen.
Webhook-Ereignisse
Abonnieren Sie mit Ihren Endpunkten die Ereignisse qr.scanned (jeder echte Scan, keine Bots) und qr.lead_captured (jeder Lead aus einem gehosteten Formular). Zustellungen sind HMAC-signiert und werden mit Backoff erneut versucht.
JavaScript-Pixel
Ein schlankes Pixel (/pixel.js) sendet Conversions auf Ihrer Website an /api/collect und verknüpft sie über eine First-Party-Attributionsreferenz (den Parameter qr_ref im Ziel-Link, gespeichert im localStorage Ihrer Website) mit dem QR-Scan, über den der Besucher kam. Kein Fingerprinting; ist Do Not Track aktiviert, wird die Conversion ohne benutzerdefinierte Eigenschaften gesendet; und es entspricht dem Datenschutzmodell der Plattform, das keine IP-Adressen im Klartext speichert.
Die Endpoints in der Praxis
JSON rein, JSON raus — authentifiziert mit einem Bearer-API-Key.
curl -X POST https://qrcode-suite.com/api/v1/qrcodes \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "dynamic_url",
"name": "Spring packaging insert",
"destination_url": "https://example.com/spring-landing"
}'# Re-point a printed code — no reprint needed
curl -X PATCH https://qrcode-suite.com/api/v1/qrcodes/$QR_ID \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://example.com/summer-landing" }'curl -X POST https://qrcode-suite.com/api/v1/conversions \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_name": "purchase",
"external_id": "order-1042",
"amount": 49.90,
"currency": "EUR",
"qr_slug": "k7Qm2x"
}'Das Bild als PNG oder SVG rendern
GET /api/qr/:slug liefert das scanbare Bild eines von Ihnen erstellten Codes: ?format=png oder ?format=svg und ?size= in Pixeln (Standard 400). Für den Druck ergibt ?dpi= (150, 300, 600 oder 1200) zusammen mit ?mm= eine Datei mit genau dieser physischen Breite in Millimetern; die Auflösung steht im PNG, damit Layoutprogramme sie in der richtigen Größe platzieren. Die Dateiendung folgt dem tatsächlich gerenderten Format: Ein Design, das der Raster-Pfad nicht flach rechnen kann, kommt als SVG zurück und ist auch so benannt. Der Endpoint braucht keinen API-Key – das Bild verrät nichts über den bereits gedruckten Slug hinaus – und ist pro gehashter IP rate-limitiert. Er rendert nur Codes, die in einem Workspace existieren; ein anonymer Generator ist er nicht.
# Screen image — no API key needed
curl -o insert.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&size=600"
# Print file: 25 mm wide at 300 DPI
curl -o insert-print.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&dpi=300&mm=25"Sie nutzen das WordPress-Plugin?
Das WordPress-Plugin bringt eigene REST-Routen auf Ihrer Website mit, unter /wp-json/qrcode-suite/v1/, authentifiziert mit Keys aus der Plugin-Verwaltung (Authorization: Bearer oder X-API-Key). Dazu kommt der WP-CLI-Befehl wp qrcs mit create, scan-stats, bulk-export, webhook-test und label-generate. Diese Routen arbeiten mit den in WordPress gespeicherten Codes, die Plattform-API oben mit Ihrem Workspace. Verbinden Sie die Website mit der Plattform (Opt-in), erscheinen ihre Codes, die täglichen Scan-Summen und die WooCommerce-Conversions in Ihrem Dashboard.
Häufig gestellte Fragen
Was ist QRCode Suite?
QRCode Suite ist eine eigenständige QR-Plattform: Erstellen Sie ein kostenloses Konto und generieren Sie markenkonforme dynamische QR-Codes im Browser — ganz ohne WordPress. Connectoren bringen dieselben Codes zu WordPress und WooCommerce, wo Bestellungen einzelnen QR-Codes zugeordnet werden können.
Funktioniert QRCode Suite ohne WordPress?
Ja. QRCode Suite ist ein eigenständiges SaaS: registrieren, QR-Codes erstellen und Scans verfolgen — alles auf qrcode-suite.com. Das WordPress-Plugin ist ein optionaler Connector, der Ihre Codes in wp-admin bringt und die WooCommerce-Bestell-Attribution ergänzt.
Benötigt QRCode Suite ein separates Abonnement?
Der Free-Plan ist kostenlos verfügbar — ohne Kreditkarte. Bezahlpläne (Pro 9 €, Business 29 €, Agency 79 € pro Monat) schalten unbegrenzte Codes, Redirect-Regeln und mehr frei. Es gibt keine Gebühr pro Scan.
Welche QR-Code-Typen unterstützt QRCode Suite?
QRCode Suite unterstützt 22 QR-Code-Typen: Statische URL, Dynamische URL, Klartext, Telefon, E-Mail, Standort, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Social-Profil, PDF, Datei-Download, App-Download, Coupon, Kalender-Event, Lead-Formular, Bewertungserfassung, Großhandelsanfrage, Treueprämie und Custom Payload.
Kann ich das Ziel eines QR-Codes nach dem Druck ändern?
Ja. Dynamische QR-Codes nutzen eine kurze Weiterleitungs-URL. Sie können das Ziel jederzeit aus Ihrem Dashboard heraus aktualisieren, ohne den Code neu zu erstellen oder zu drucken.
Ist QRCode Suite DSGVO-konform?
QRCode Suite ist im Sinne der DSGVO konzipiert: Rohe IP-Adressen werden nie gespeichert — Besucher werden über Schlüssel-Hashes gezählt —, Bot-Traffic wird automatisch gefiltert, und Scan-Ereignisse werden nach Ablauf des Aufbewahrungsfensters Ihres Tarifs gelöscht. Wenden Sie sich für Ihre konkreten Pflichten an Ihr Rechtsteam.
Auf der QRCode-Suite-API bauen
Scoped API-Keys und REST-Endpoints — ab Business enthalten.