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
- Im Konto unter API einen Schlüssel erstellen. Er wird nur einmal angezeigt.
- Den Schlüssel bei jeder Anfrage als
Authorization: Bearer …mitschicken. - 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
errorspro 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.