REST-API

Erstellen, ändern und messen Sie Ihre QR-Codes aus Ihren eigenen Tools heraus. Verfügbar ab dem Pro-Tarif.

Authentifizierung

Jeder Arbeitsbereich kann in seinen Einstellungen API-Schlüssel erstellen. Der Schlüssel wird nur einmal angezeigt. Senden Sie ihn im Authorization-Header.

curl -H "Authorization: Bearer sc_xxxxxxxx…" https://www.scanolo.com/api/v1/codes

Endpunkte

Methode	Pfad	Beschreibung
`GET`	`/api/v1/codes`	Liste der Codes des Arbeitsbereichs (paginiert).
`POST`	`/api/v1/codes`	Erstellt einen Code. JSON-Body: name, kind, mode, payload, design.
`GET`	`/api/v1/codes/{id}`	Details eines Codes, inklusive Kurzadresse.
`PATCH`	`/api/v1/codes/{id}`	Ändert Name, Ziel, Design oder Status.
`DELETE`	`/api/v1/codes/{id}`	Löscht einen Code (er hört nach expliziter Bestätigung auf, weiterzuleiten).
`GET`	`/api/v1/codes/{id}/image.svg`	Bild des Codes als SVG oder PNG (Parameter size für PNG).
`GET`	`/api/v1/codes/{id}/stats`	Scan-Statistiken zwischen zwei Daten.
`POST`	`/api/v1/render`	Rendering eines statischen Codes, ohne ihn zu speichern.

Beispiel

curl -X POST https://www.scanolo.com/api/v1/codes \
  -H "Authorization: Bearer sc_xxxxxxxx…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Menu terrasse", "kind": "url", "mode": "dynamic",
       "payload": {"url": "https://example.com/menu"},
       "design": {"fg": "#10211F", "module": "rounded"}}'

{"id": 42, "slug": "k7Hp3Qz", "short_url": "https://www.scanolo.com/r/k7Hp3Qz",
 "kind": "url", "mode": "dynamic", "status": "active", "safety_status": "safe",
 "scans_total": 0, "created_at": "2026-09-06T10:00:00Z"}

Limits

Pro: 60 Anfragen pro Minute. Business: 300. Darüber hinaus antwortet der Server mit 429 und einem Retry-After-Header. Die Kontingente für dynamische Codes des Tarifs gelten auch für die API.

API-Schlüssel erhalten