Skip to main content
GET
Lädt ein gerendertes QR-Code-Bild auf dem Management-API-Host (management.scanova.io) herunter, authentifiziert mit Ihrem rohen Management-API-Schlüssel.
string
erforderlich
Die qrid des QR-Codes, z. B. QR7K9M2XN.
Auch erreichbar unter /qr/{qrid}/download/ — dieselbe View, dasselbe Verhalten.

Query-Parameter

string
Standard:"png"
Ausgabeformat: png, jpg, jpeg, svg, pdf, eps oder ps.
integer
Standard:"300"
Bildgröße in Pixeln, von 10 bis 2400.
boolean
Standard:"false"
Bei true wird ein druckfertiges PDF zurückgegeben, das lokal generiert wird (nicht über den Bildgenerator-Dienst), und file wird ignoriert.
string
Optionaler Override des vorkodierten Payloads. Dynamische QR-Codes benötigen dies nicht — es existiert für statische QR-Codes, da dieses Backend die clientseitige Datenkodierungslogik des Frontends für statische Typen nicht eigenständig reproduziert.

Antwort

Eine erfolgreiche Anfrage gibt das Bild als Binärdatei-Download zurück (Content-Disposition: attachment), mit einem Dateinamen, der aus dem Namen des QR-Codes abgeleitet wird (oder aus seiner qrid, falls unbenannt).

Fehler

Wird zurückgegeben, wenn size außerhalb von 102400 liegt oder file keinem der unterstützten Formate entspricht.
Die qrid existiert nicht oder gehört nicht zu dem Konto, zu dem der Schlüssel gehört.
Der vorgelagerte Bildgenerator-Dienst ist nicht erreichbar. Dies ist kein Client-Fehler — versuchen Sie es erneut und kontaktieren Sie den Support, falls das Problem weiterhin besteht.

Verwandte Themen

Autorisierungen

Authorization
string
header
erforderlich

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

Pfadparameter

qrid
string
erforderlich

Antwort

200

QR image binary