QR-Codes direkt aus deiner Software verwalten

Lege QR-Codes direkt aus deinem Bestell- oder Projektsystem an, ändere Ziele und rufe Scan-Zahlen ab. Enthalten im Business- und Agentur-Plan.

In drei Schritten

  1. Im Konto unter API einen Schlüssel erstellen. Er wird nur einmal angezeigt.
  2. Den Schlüssel bei jeder Anfrage als Authorization: Bearer … mitschicken.
  3. Anfragen und Antworten sind JSON. Basis-Adresse: https://qr9.ch/api/v1

Einen Code anlegen

Ohne type entsteht ein dynamischer Code. slug ist der lesbare Kurzlink; fehlt er, vergeben wir einen zufälligen.

curl -X POST https://qr9.ch/api/v1/qr-codes \
  -H "Authorization: Bearer qr9_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"name": "Flyer Sommer", "target_url": "https://example.ch/sommer", "slug": "sommer-aktion"}'

Die Antwort:

{
  "data": {
    "id": "k3x9q7m2p0a8d4fz",
    "name": "Flyer Sommer",
    "type": "dynamic",
    "target_url": "https://example.ch/sommer",
    "slug": "sommer-aktion",
    "short_url": "https://qr9.ch/r/sommer-aktion",
    "client_id": null,
    "custom_domain": null,
    "scan_count": 0,
    "expires_at": null
  }
}

Die id ist eine zufällige Zeichenfolge, keine fortlaufende Nummer. Mit ihr sprichst du den Code später an.

Weitere Felder beim Anlegen: client_id, custom_domain_id, expires_at (Datum) und design mit fg_color, bg_color, dot_style (square oder round).

Das Ziel ändern

Der gedruckte Code bleibt gleich. Änderst du den Kurzlink, funktioniert der alte weiter.

curl -X PATCH https://qr9.ch/api/v1/qr-codes/k3x9q7m2p0a8d4fz \
  -H "Authorization: Bearer qr9_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://example.ch/herbst"}'

Alle Endpunkte

GET /qr-codes Alle QR-Codes auflisten. Filter: client_id, per_page (max. 100), page.
POST /qr-codes Einen Link-Code anlegen.
GET /qr-codes/{id} Einen QR-Code abrufen.
PATCH /qr-codes/{id} Name, Ziel, Kurzlink, Projekt oder Ablaufdatum ändern.
GET /qr-codes/{id}/image Das Bild als SVG oder PNG (format=svg|png).
GET /qr-codes/{id}/scans Scans gesamt und pro Tag (days, max. 90).
GET /clients Deine Projekte, um Codes zuzuordnen.
POST /clients Ein Projekt anlegen (name, optional company).
GET /domains Deine eigenen Domains, für custom_domain_id beim Anlegen.

Gut zu wissen

  • Fehler kommen als JSON mit passendem Status: 401 ohne gültigen Schlüssel, 403 ohne passenden Plan oder bei erreichtem Limit, 404 für unbekannte Codes, 422 bei ungültigen Eingaben (mit errors pro Feld).
  • Limit: 120 Anfragen pro Minute und Konto. Darüber antwortet die API mit 429.
  • Löschen geht bewusst nur im Dashboard. Ein gelöschter Code macht alles unbrauchbar, was damit gedruckt wurde.
  • Sicherheit: Jedes Ziel wird wie im Dashboard gegen Phishing und Malware geprüft.
  • Für Werkzeuge und KI: Die API ist als OpenAPI-Beschreibung und als llms.txt abrufbar.

Erstelle deinen ersten QR-Code.

Bis zu 3 Codes im kostenlosen Konto. Ohne Kreditkarte.

Jetzt starten