CodesQR

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

POST /v1/qr

Einen statischen oder dynamischen QR-Code erstellen.

GET /v1/qr/{id}

Einen einzelnen QR-Code und seine Bild-URLs abrufen.

PATCH /v1/qr/{id}

Das Ziel oder den Titel eines dynamischen Codes ändern.

GET /v1/qr/{id}/stats

Scan-Analysen für einen dynamischen Code lesen.

GET /v1/qr

Die QR-Codes in Ihrem Konto auflisten.

DELETE /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 erstellen

Ihr 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