generate

Erzeugt einen QR-Code aus einer expliziten Konfiguration. Das ist der zentrale Render-Endpunkt – sowohl die Editor-Oberfläche als auch der KI-Endpunkt münden hier.

Anfrage

Content-Type: application/json oder multipart/form-data (für binäre Logo-/Hintergrund-Uploads).

Body-Struktur: ein QrConfig-Objekt.

Minimales Beispiel:

Multipart-Upload (Logo als Datei)

curl -X POST https://api.qr-branding.com/api/qr/generate \
  -H "X-RapidAPI-Proxy-Secret: <secret>" \
  -F 'config={"content":"https://yourbrand.com","logoSizePercent":18,"eccLevel":"H"}' \
  -F "logoFile=@./brand-mark.png"

Das Feld config ist ein JSON-codierter String. logoFile und backgroundFile sind binäre Teile (PNG / JPG / GIF / BMP / WebP bis 10 MB).

Antwort (base64-Modus – Standard)

{
  "success": true,
  "qrBase64": "iVBORw0KGgoAAAANSUhEUgAA…",
  "format": "png",
  "contentType": "image/png",
  "sizeBytes": 38291
}

Antwort (Binärmodus)

{ "responseType": "binary" }

Gibt die rohen Dateibytes mit passendem Content-Type und Content-Disposition: attachment; filename="qrcode.png" zurück.

Validierung

Die Engine durchläuft die komplette Pipeline der Scan-Garantie. Häufige Ablehnungsgründe:

Code	Bedeutung	Lösung
`CONTENT_TOO_LONG`	Codierter String > 4296 Zeichen	Kürzen / einen URL-Kürzer nutzen
`LOW_CONTRAST`	Vordergrund vs. Hintergrund < 4:1	Dunkleren Vorder- oder helleren Hintergrund wählen
`LOGO_TOO_LARGE`	`logoSizePercent` > 25 bei ECC < H	Auf H erhöhen oder das Logo verkleinern
`INVALID_HEX`	Farbwert nicht `#RGB`, `#RRGGBB`, `#RRGGBBAA`	Farbe korrigieren
`INVALID_LLM_MODEL`	Nur beim KI-Endpunkt	Siehe KI-Modus

Siehe auch

QrConfig-Referenz – jeder akzeptierte Parameter
POST /api/qr/ai/generate – dieselbe Engine, Konfiguration per KI