REST API

QR-Codes im Großen Maßstab Generieren mit Unserer REST API

Integrieren Sie QR-Code-Erstellung, -Verwaltung und -Analytik in jede Anwendung. RESTful JSON API mit API-Schlüssel-Authentifizierung, ZIP-Massenexport und Echtzeit-Webhooks.

POST /api/v1/qr-codes

{ "type": "url", "data": "https://example.com" }

Die QR-Verse REST API ermöglicht Entwicklern, QR-Codes programmatisch zu erstellen, zu verwalten und zu tracken. Exportieren Sie bis zu 50 bestehende Codes als ZIP-Datei über den Bulk-Export-Endpunkt, erhalten Sie Echtzeit-Scan-Benachrichtigungen über Webhooks und greifen Sie auf detaillierte Analytics zu. Authentifizieren Sie sich mit einem einfachen API-Schlüssel und starten Sie die Integration in wenigen Minuten mit jedem HTTP-Client.

Einen QR-Code in Sekunden erstellen

Eine POST-Anfrage genügt. Senden Sie Ihre Daten und erhalten Sie einen scannbaren QR-Code mit nachverfolgbarer Kurz-URL und herunterladbarem Bild.

Anfrage

cURL

curl -X POST \

https://qr-verse.com/api/v1/qr-codes \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "Content-Type: application/json" \

-d '{

"name": "Spring campaign",

"destination_url": "https://example.com"

Antwort

201 Created

{

"data": {

"id": "qr_abc123",

"name": "Spring campaign",

"qr_type": "url",

"destination_url": "https://example.com",

"is_active": true,

"redirect_slug": "abc123",

"tags": [],

"created_at": "2026-10-09T12:00:00Z"

}

Alles, was Sie zum Entwickeln brauchen

Eine vollständige API für das QR-Code-Lifecycle-Management. Von der Erstellung und Gestaltung bis hin zu Scan-Tracking und Echtzeit-Benachrichtigungen.

Vollständige CRUD-Operationen

QR-Codes programmatisch erstellen, lesen, aktualisieren und löschen. Alle QR-Typen unterstützt - URL, vCard, WLAN, E-Mail, SMS und mehr.

ZIP-Massenexport

Bis zu 50 bestehende QR-Codes als ZIP-Datei in einer einzigen API-Anfrage exportieren. Download als PNG oder SVG mit Beibehaltung des Original-Stils.

Analytics API

Scan-Daten programmatisch abrufen. Summen für einen Zeitraum und ein Datensatz pro Scan: Zeitpunkt, Land, Stadt, Gerätetyp, Betriebssystem, Browser und UTM-Parameter.

Webhook-Ereignisse

Echtzeit-HTTP-Benachrichtigungen erhalten, wenn Ihre QR-Codes gescannt werden. Workflows in Ihrem CRM, Analysetools oder Automatisierungsplattformen auslösen.

API-Schlüsselverwaltung

API-Schlüssel über das Dashboard generieren, rotieren und widerrufen. Pro- und Business-Pläne unterstützen mehrere Schlüssel für verschiedene Umgebungen.

Rate Limiting

Das Erstellen von QR-Codes über die API ist auf 30 Anfragen pro 60 Sekunden pro API-Schlüssel begrenzt. Darüber antwortet die API mit dem Status 429.

API-Zugang nach Plan

API-Zugang beginnt bei Pro. Business ergänzt den Massenimport aus einer CSV-Datei in der Weboberfläche und höhere Limits für Webhooks und API-Schlüssel für Team-Umgebungen.

Funktion	Kostenlos 0 EUR/Monat	Pro 4,99 €/Monat	Business 12,99 €/Monat
REST API-Zugang
API-Schlüsselverwaltung
Erstellen / Lesen / Aktualisieren / Löschen
Dynamische QR-Codes aus einer Ziel-URL
Analytics-Datenabruf
Ratenlimit (Codes erstellen)	0	30 / min	30 / min
ZIP-Massenexport (bis zu 50 Codes)
Webhook-Benachrichtigungen
Mehrere API-Schlüssel

Mit Pro starten Alle Pläne vergleichen

Für Ihren Tech-Stack gebaut

Ob Sie einen Online-Shop betreiben, Vertriebspipelines verwalten oder Marketingkampagnen automatisieren - die QR-Verse API fügt sich nahtlos in Ihren bestehenden Workflow ein.

E-Commerce-Plattformen

QR-Codes für jedes Produkt in Ihrem Katalog automatisch generieren. Verlinken Sie auf Produktseiten, fügen Sie sie Verpackungen hinzu oder betten Sie sie in Quittungen ein. Bestehende Codes als ZIP-Datei über die API exportieren - ideal für Druck- und Verpackungsworkflows.

Shopify, WooCommerce oder eigene Online-Shops

CRM & Vertriebstools

Personalisierte QR-Codes für Vertriebsmaterialien, Visitenkarten oder Kundenportale erstellen. Webhooks nutzen, um Scans als CRM-Aktivitäten zu protokollieren und das Engagement pro Kontakt zu verfolgen.

HubSpot, Salesforce, Pipedrive

Marketing-Automatisierung

Dynamische QR-Codes in E-Mail-Kampagnen, Printanzeigen oder Event-Materialien einbetten. Scan-Analysen über die API abrufen, um den Kampagnen-ROI neben Ihren bestehenden Marketingdaten zu messen.

Mailchimp, ActiveCampaign, Zapier

Alle Integrationen und Webhook-Einrichtung ansehen

Entwicklerfreundlichkeit

Von Entwicklern für Entwickler. Vorhersagbare Antworten, klare Dokumentation und stabile Versionierung - damit Sie sicher deployen können.

API-Schlüssel mit Scopes

Geben Sie jedem Schlüssel nur die Rechte, die er braucht: qr:read, qr:write, qr:create und analytics:read. Ein Schlüssel ohne den Scope eines Endpunkts erhält ein 403, und ein Sitzungstoken eines angemeldeten Nutzers wird von der API nicht akzeptiert.

JSON-Antworten

Saubere, konsistente JSON-Antworten mit vorhersagbarer Struktur. Jeder Endpunkt gibt dasselbe Format zurück - Daten-, Paginierungs- und Fehlerobjekte, auf die Sie sich verlassen können.

Fehlerbehandlung

Strukturierte Fehlerantworten mit HTTP-Statuscodes, maschinenlesbaren Fehlercodes und verständlichen Meldungen. Probleme schnell debuggen, ohne zu raten.

API-Versionierung

Versionierte API-Endpunkte (v1) mit Garantien zur Abwärtskompatibilität. Bahnbrechende Änderungen werden nur in neuen Hauptversionen eingeführt, damit Ihre Integration stabil bleibt.

Verfügbare Endpunkte

GET/api/v1/qr-codes- QR-Codes auflisten (paginiert)

POST/api/v1/qr-codes- QR-Code erstellen

GET/api/v1/qr-codes/:id- QR-Code-Details abrufen

PATCH/api/v1/qr-codes/:id- QR-Code aktualisieren

DELETE/api/v1/qr-codes/:id- QR-Code löschen

GET/api/v1/qr-codes/:id/scans- Scan-Analysen abrufen

Häufig gestellte Fragen

Welche Authentifizierungsmethode verwendet die QR-Verse API?

Die API verwendet API-Schlüssel-Authentifizierung über Bearer-Tokens. Fügen Sie Ihren API-Schlüssel im Authorization-Header als "Bearer IHR_API_SCHLÜSSEL" hinzu. API-Schlüssel können Sie im Dashboard generieren und verwalten.

Welche QR-Code-Typen kann ich über die API erstellen?

Die API erstellt dynamische QR-Codes, die auf eine Ziel-URL weiterleiten: Senden Sie name und destination_url an POST /api/v1/qr-codes. Das Feld type ist eine Bezeichnung (url, link, text, email, wifi, vcard, sms, phone, geo, event, crypto oder social), der Inhalt ist immer die URL. Codes mit eigenen Daten, etwa eine vCard oder ein WLAN-Netzwerk, erstellen Sie in der Web-App.

Wie funktioniert der ZIP-Massenexport?

Nutzer der Pläne Pro und Business können bis zu 50 bestehende QR-Codes als ZIP-Datei exportieren - per POST /api/qr/bulk-export, mit einer Sitzung oder einem API-Schlüssel mit dem Scope qr:read. Die IDs der gewünschten Codes werden angegeben, dazu das Format PNG oder SVG. Die API gibt eine ZIP-Datei zurück, die jeden Code als separate Datei mit dem ursprünglichen Design enthält.

Was passiert, wenn ich das Rate Limit erreiche?

Das Erstellen eines Codes (POST /api/v1/qr-codes) ist auf 30 Anfragen pro 60-Sekunden-Fenster pro API-Schlüssel begrenzt. Darüber antwortet die API mit dem Status 429 und der Meldung "Rate limit exceeded". Die Antworten enthalten weder Rate-Limit-Header noch eine Reset-Zeit: Warten Sie eine Minute und versuchen Sie es erneut.

Kann ich das Aussehen von QR-Codes über die API anpassen?

Nicht über die v1-API. Ein über die API erstellter Code beginnt mit dem Standardstil (schwarz auf weiß); anschließend können Sie ihn in der Web-App anpassen. Farben, Fehlerkorrektur und Ausgabeformat sind keine Parameter von POST /api/v1/qr-codes.

Wie funktionieren Webhooks für Scan-Ereignisse?

Nutzer der Pro- und Business-Pläne können Webhook-URLs im Dashboard registrieren. Wenn einer Ihrer QR-Codes gescannt wird, senden wir eine POST-Anfrage an Ihre Webhook-URL mit Scan-Details: das Ereignis und ein Zeitstempel, dazu ID und Name des QR-Codes, Land und Stadt, Gerätetyp, Betriebssystem, Browser, ob der Scan eindeutig ist, und die UTM-Parameter (kein Referrer). Webhooks verwenden HMAC-Signaturen zur Verifizierung.

Ist die API im kostenlosen Tarif verfügbar?

Nein. Der API-Zugang erfordert einen Pro-Plan (4,99 €/Monat) oder Business-Plan (12,99 €/Monat). Der kostenlose Tarif beinhaltet den webbasierten QR-Generator, aber keinen programmatischen API-Zugang.

Kann ich Analytics-Daten über die API abrufen?

Ja. Sowohl Pro- als auch Business-Pläne bieten API-Zugang zu Scan-Analysen, mit einem Schlüssel, der den Scope analytics:read hat. GET /api/v1/qr-codes/:id/scans liefert die Scans eines QR-Codes seitenweise (Zeitpunkt, Land, Stadt, Gerätetyp, Betriebssystem, Browser, eindeutig oder nicht, UTM-Parameter) und eine Zusammenfassung mit der Gesamtzahl der Scans, den Scans und eindeutigen Scans im Zeitraum und der Länge des Zeitraums. Eine Aufschlüsselung nach Tag, Woche oder Monat und den Referrer gibt es nicht: aggregieren Sie die Datensätze selbst.

QR-Codes in Ihren Workflow integrieren

Die QR-Verse REST API ermöglicht es Ihnen, QR-Codes programmatisch zu erstellen, zu verwalten und Scan-Analysen abzurufen. Jede im Dashboard verfügbare Operation ist auch über die API zugänglich, sodass Ihr Entwicklungsteam QR-Code-Generierung direkt in interne Tools, E-Commerce-Plattformen, Fulfillment-Pipelines oder SaaS-Produkte einbauen kann.

Häufige Integrationsmuster umfassen die programmatische Generierung - das Erstellen eindeutiger QR-Codes, eine Anfrage pro Code, jeweils mit einer eigenen Ziel-URL und optionalen benutzerdefinierten Metadaten. Dies ist ideal für Produktserialisierung, Ticket-Systeme oder Treuekartenprogramme. Die API gibt jeden generierten Code als SVG oder PNG im Antwort-Body zurück.

Der Scan-Analytics-Endpunkt bietet Echtzeitzugriff auf dieselben Daten wie das Dashboard - Gesamtscans, eindeutige Scans, geografische Aufschlüsselung, Geräteaufschlüsselung und Zeitreihendaten - alles als strukturiertes JSON. Das bedeutet, Sie können QR-Scan-Ereignisse direkt in Ihr eigenes Data Warehouse, CRM oder Reporting-Tool leiten. Webhook-Unterstützung ist in den Tarifen Pro und Business verfügbar.

Die API ist bewusst klein: sechs Endpunkte unter /api/v1, JSON als Ein- und Ausgabe und ein API-Schlüssel mit Scopes für den Zugriff. Die Endpunkte sind auf dieser Seite aufgelistet, und das Beispiel unten zeigt eine Anfrage und ihre Antwort. Es gibt keine SDK-Pakete und keine gehostete interaktive Dokumentation: Ein einfacher HTTP-Client wie cURL oder fetch genügt.

Pro-Plan erforderlich

Ihren API-Schlüssel erhalten

Registrieren Sie sich für Pro oder Business, generieren Sie Ihren API-Schlüssel im Dashboard und beginnen Sie in Minuten mit Anfragen.

Jetzt loslegen

Entdecke weitere Funktionen

Bulk QR Code Generator

Erstellen Sie Hunderte QR-Codes aus CSV in Sekunden

Dynamic QR Codes

Aktualisiere QR-Ziele ohne Neudruck

QR Code Analytics

Verfolge Scans, Standorte und Gerate in Echtzeit