QRCode SuiteQR-Plattform
Entwickler

QR-Code-API für Entwickler

QRCode Suite stellt auf der Plattform eine versionierte REST-API bereit: QR-Codes erstellen, Ziele umleiten und Scan-Analysen abrufen — mit derselben Engine wie das Dashboard. Authentifiziert wird mit scoped API-Keys aus dem Dashboard. Außerdem erfasst sie Conversions über /api/v1/conversions, sendet HMAC-signierte Webhooks für Scans und Formular-Leads und liefert ein JavaScript-Pixel für Conversions auf Ihrer Website.

API-Zugriff ist im Business- und Agency-Plan enthalten.

Kostenlos starten →Preise ansehen

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.

Business-Plan ansehenDokumentation lesen