Logo im QR-Code

Ein Code kann ein optionales Logo in seiner Mitte tragen – die eigene Marke statt eines reinen QR-Musters. Das Logo wird als tatsächliche Pixel in die SVG- und PNG-Downloads eingebettet; PDF und EPS enthalten es nie.

Im Dashboard

Öffne die Detailseite eines Codes. Neben der QR-Vorschau und den Download-Buttons liegt die Karte Logo im QR-Code.

Klicke auf Logo auswählen und wähle eine PNG-, JPEG- oder WebP-Datei (höchstens 1 MB – größere oder andere Formate, SVG eingeschlossen, werden schon vor dem Hochladen abgelehnt).
Eine Vorschau der gewählten Datei erscheint zusammen mit einem Hinweis:
- Noch kein Logo vorhanden – das Hinzufügen ändert das Punktmuster des Codes. Häkchen bestätigen, dann auf Logo hochladen klicken.
- Ein Logo ist schon gesetzt – ein Ersetzen tauscht nur das Bild in der Mitte, das Muster bleibt gleich. Auf Logo ersetzen klicken; eine Bestätigung ist nicht nötig.
Zum Entfernen auf Logo entfernen klicken, das Warn-Häkchen bestätigen (auch das Entfernen ändert das Muster) und die Entfernung ein zweites Mal bestätigen.

Per API

Logo hochladen oder ersetzen

POST /v1/codes/{id}/logo – Multipart-Request, Feld file.

cURL

curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..." \
  -F "[email protected]"

Antwort (HTTP 201): der aktualisierte Code, mit gesetztem logo_file_id.

Die Datei wird anhand ihrer Magic Bytes geprüft, nicht anhand der Endung oder des Content-Type. Sie wird auf ein transparentes PNG mit 512 × 512 px normalisiert (Seitenverhältnis erhalten). Ein bestehendes Logo wird ersetzt – pro Code gibt es immer nur ein Logo.

Logo entfernen

DELETE /v1/codes/{id}/logo – ohne Body.

curl -X DELETE https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..."

Antwort (HTTP 200): der aktualisierte Code, logo_file_id wieder auf null gesetzt. Idempotent – ein Aufruf ohne bestehendes Logo liefert weiterhin 200 und ändert nichts.

Fehler

Status	Wann
403	Die Rolle des API-Keys ist `viewer`
404	Code im Workspace nicht gefunden
413	Die Datei ist größer als 1 MB
422	Feld `file` fehlt, oder ein anderes Format als PNG/JPEG/WebP (SVG eingeschlossen)

Was sich am Code ändert

qr.svg und qr.png betten die tatsächlichen Pixel des Logos zentriert ein, skaliert auf einen festen Anteil der Codefläche. Beide heben dafür die Fehlerkorrektur auf H an, damit der Code scannbar bleibt. qr.pdf und qr.eps sind von einem Logo unberührt – sie betten nie eines ein und behalten das Muster, das sie auch ohne Logo hätten.

Cache

Mit gesetztem Logo werden qr.svg/qr.png mit Cache-Control: public, max-age=300 (5 Minuten) ausgeliefert statt der sonst üblichen public, max-age=86400, immutable (24 Stunden). Eine anderswo eingebettete Bild-URL – auf einer Seite, in einer E-Mail, in einem Dokument – übernimmt eine Logo-Änderung also innerhalb von bis zu 5 Minuten. Eine Kopie, die zwischengespeichert wurde, bevor ein Code je ein Logo hatte, kann bis zu volle 24 Stunden brauchen, weil sie unter der längeren, unveränderlichen Lebensdauer gecacht wurde.

Druck

Ein bereits gedruckter Code funktioniert weiter, egal ob ein Logo hinzugefügt, ersetzt oder entfernt wird – das kodierte Ziel hängt nie am Logo.
Hinzufügen oder Entfernen eines Logos ändert das Punktmuster. Soll das Logo selbst auf dem Druckmaterial erscheinen, neu drucken mit dem aktuellen qr.svg oder qr.png – alte und neue Druckdateien dabei nie mischen.
Ersetzen eines Logos ändert das Muster nicht; ein Neudruck ist dann nur eine Frage des gewünschten neuen Bildes, nicht der Scanbarkeit.
qr.pdf und qr.eps enthalten nie ein Logo. Für Druckvorlagen, die das Logo zeigen sollen, qr.svg oder qr.png herunterladen.
Vor einem vollständigen Druckauflauf immer einen Probescan auf dem echten Material machen, besonders nach einer Musteränderung.