Für Entwickler
QR-Code-API
Generieren Sie QR-Codes und lesen Sie Scan-Analysen direkt aus Ihrem eigenen Code. Die CodesQR-API ist eine kleine, berechenbare REST-Schnittstelle, die JSON zurückgibt und in jedem CodesQR-Konto verfügbar ist.
Authentifizierung
Jede Anfrage wird mit einem geheimen API-Schlüssel authentifiziert, der als Bearer-Token gesendet wird. Erstellen Sie einen Schlüssel in Ihrem Dashboard unter Einstellungen, bewahren Sie ihn serverseitig auf und geben Sie ihn niemals in Client-Code preis. Alle Anfragen laufen über HTTPS an https://api.codesqr.com.
Authorization: Bearer sk_live_your_api_key
Endpunkte
/v1/qr
Einen statischen oder dynamischen QR-Code erstellen.
/v1/qr/{id}
Einen einzelnen QR-Code und seine Bild-URLs abrufen.
/v1/qr/{id}
Das Ziel oder den Titel eines dynamischen Codes ändern.
/v1/qr/{id}/stats
Scan-Analysen für einen dynamischen Code lesen.
/v1/qr
Die QR-Codes in Ihrem Konto auflisten.
/v1/qr/{id}
Einen QR-Code löschen.
Einen QR-Code erstellen
Senden Sie ein POST an /v1/qr mit dem Typ und dem Ziel. Setzen Sie dynamic: true, um einen bearbeitbaren, verfolgbaren Code zu erhalten, den Sie später aktualisieren können. Die Antwort enthält einsatzbereite PNG- und SVG-Bild-URLs.
Anfrage
curl https://api.codesqr.com/v1/qr \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"type": "url",
"target": "https://example.com/spring-sale",
"dynamic": true,
"title": "Spring Sale Poster",
"color": { "dark": "#059669", "light": "#ffffff" },
"format": "png"
}'
Antwort
{
"id": "qr_8fK2p1Qz",
"type": "url",
"target": "https://example.com/spring-sale",
"dynamic": true,
"short_url": "https://csqr.io/8fK2p1Qz",
"image_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.png",
"svg_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.svg",
"scans": 0,
"created_at": "2026-07-18T10:24:00Z"
}
Einen dynamischen Code aktualisieren
Da ein dynamischer QR-Code dasselbe gedruckte Muster behält, können Sie ihn jederzeit mit einem PATCH woanders hin verweisen lassen. Bestehende gedruckte Codes funktionieren weiter, kein Neudruck erforderlich.
Anfrage
curl -X PATCH https://api.codesqr.com/v1/qr/qr_8fK2p1Qz \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "target": "https://example.com/summer-sale" }'
Scan-Statistiken lesen
Für dynamische Codes rufen Sie Scan-Analysen mit einem GET an /v1/qr/{id}/stats ab. Sie erhalten Summen, eine tägliche Aufschlüsselung und eine Geräteaufteilung, die Sie in Diagrammen darstellen oder exportieren können.
Anfrage
curl https://api.codesqr.com/v1/qr/qr_8fK2p1Qz/stats \
-H "Authorization: Bearer sk_live_your_api_key"
Antwort
{
"id": "qr_8fK2p1Qz",
"total_scans": 1842,
"unique_scans": 1310,
"range": "last_30_days",
"by_day": [
{ "date": "2026-07-16", "scans": 74 },
{ "date": "2026-07-17", "scans": 91 },
{ "date": "2026-07-18", "scans": 63 }
],
"by_device": { "mobile": 1521, "desktop": 248, "tablet": 73 }
}
Ratenbegrenzungen und Fehler
Die API gibt standardmäßige HTTP-Statuscodes zurück: 200 bei Erfolg, 400 bei einer fehlerhaften Anfrage, 401 bei einem falschen Schlüssel und 429, wenn Sie die Ratenbegrenzung Ihres Tarifs überschreiten. Fehlerantworten enthalten einen maschinenlesbaren code und eine menschenlesbare message. Lieber gar kein Code? Sie können alles von Hand in der App erstellen und verwalten oder zuerst alle QR-Code-Typen erkunden.
Bereit zu bauen?
Erstellen Sie ein kostenloses CodesQR-Konto, generieren Sie einen API-Schlüssel in den Einstellungen und erstellen Sie Ihren ersten QR-Code mit einer einzigen Anfrage.
Kostenloses Konto erstellenIhr nachverfolgbarer QR-Code ist nur eine Minute entfernt
Lassen Sie einen Code auf jeden Link oder jede Datei verweisen, verfolgen Sie jeden Scan und ändern Sie das Ziel, wann immer Sie möchten.
Meinen kostenlosen QR-Code erstellen- Für immer kostenlos
- Keine Kreditkarte
- In Minuten eingerichtet