Logo în codul QR

Un cod poate conține un logo opțional în centrul său – propria marcă în locul unui simplu model QR. Logo-ul este încorporat ca pixeli reali în descărcările SVG și PNG; fișierele PDF și EPS nu îl conțin niciodată.

În Dashboard

Deschideți pagina de detalii a unui cod. Lângă previzualizarea QR și butoanele de descărcare se află cardul Logo în codul QR.

Faceți clic pe Selectare logo și alegeți un fișier PNG, JPEG sau WebP (maximum 1 MB – formatele mai mari sau diferite, inclusiv SVG, sunt respinse înainte de încărcare).
Apare o previzualizare a fișierului selectat, împreună cu o notificare:
- Nu există încă un logo – adăugarea modifică modelul de puncte al codului. Bifați caseta de confirmare, apoi faceți clic pe Încărcare logo.
- Un logo este deja setat – înlocuirea schimbă doar imaginea din centru, modelul rămâne același. Faceți clic pe Înlocuire logo; nu este necesară o confirmare.
Pentru eliminare, faceți clic pe Eliminare logo, bifați caseta de avertizare (eliminarea modifică, de asemenea, modelul) și confirmați eliminarea a doua oară.

Prin API

Încărcarea sau înlocuirea logo-ului

POST /v1/codes/{id}/logo – cerere multipart, câmpul file.

cURL

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

Răspuns (HTTP 201): codul actualizat, cu logo_file_id setat.

Fișierul este verificat pe baza octeților săi magici (magic bytes), nu pe baza extensiei sau a antetului Content-Type. Acesta este normalizat la un format PNG transparent de 512 × 512 px (păstrând raportul de aspect). Un logo existent este înlocuit – există întotdeauna un singur logo per cod.

Eliminarea logo-ului

DELETE /v1/codes/{id}/logo – fără corp (body).

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

Răspuns (HTTP 200): codul actualizat, cu logo_file_id resetat la null. Idempotent – un apel fără un logo existent returnează în continuare 200 și nu modifică nimic.

Erori

Status	Când
403	Rolul cheii API este `viewer`
404	Codul nu a fost găsit în spațiul de lucru
413	Fișierul este mai mare de 1 MB
422	Câmpul `file` lipsește sau este un alt format decât PNG/JPEG/WebP (inclusiv SVG)

Ce se modifică la cod

qr.svg și qr.png încorporează pixelii reali ai logo-ului în centru, scalați la o proporție fixă din suprafața codului. Ambele cresc corecția erorilor la H pentru ca codul să rămână scanabil. Fișierele qr.pdf și qr.eps nu sunt afectate de logo – ele nu încorporează niciodată unul și păstrează modelul pe care l-ar avea și fără logo.

Cache

Atunci când este setat un logo, qr.svg/qr.png sunt livrate cu Cache-Control: public, max-age=300 (5 minute) în loc de valoarea obișnuită public, max-age=86400, immutable (24 de ore). Astfel, un URL de imagine încorporat în altă parte – pe o pagină, într-un e-mail, într-un document – va prelua modificarea logo-ului în maximum 5 minute. O copie care a fost stocată în cache înainte ca un cod să aibă vreodată un logo poate avea nevoie de până la 24 de ore complete, deoarece a fost stocată în cache cu durata de viață mai lungă și imuabilă.

Tipărire

Un cod deja tipărit continuă să funcționeze, indiferent dacă un logo este adăugat, înlocuit sau eliminat – destinația codificată nu depinde niciodată de logo.
Adăugarea sau eliminarea unui logo modifică modelul de puncte. Dacă doriți ca logo-ul însuși să apară pe materialul tipărit, tipăriți din nou folosind fișierul curent qr.svg sau qr.png – nu amestecați niciodată fișierele de tipărire vechi și noi.
Înlocuirea unui logo nu modifică modelul; o nouă tipărire este atunci doar o chestiune de actualizare a imaginii dorite, nu de scanabilitate.
Fișierele qr.pdf și qr.eps nu conțin niciodată un logo. Pentru șabloanele de tipărire care trebuie să afișeze logo-ul, descărcați qr.svg sau qr.png.
Înainte de un tiraj complet de tipărire, efectuați întotdeauna o scanare de probă pe materialul real, în special după o modificare a modelului.