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 toate cele patru descărcări: SVG, PNG, PDF și EPS.
În Dashboard
Deschide pagina de detalii a unui cod. Lângă previzualizarea QR și butoanele de descărcare se află cardul Logo în codul QR.
- Dă clic pe Selectare logo și alege 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. Bifează caseta de confirmare, apoi dă clic pe Încărcare logo.
- Un logo este deja setat – înlocuirea schimbă doar imaginea din centru, modelul rămâne același. Dă clic pe Înlocuire logo; nu este necesară o confirmare.
- Pentru eliminare, dă clic pe Eliminare logo, bifează caseta de avertizare (eliminarea modifică, de asemenea, modelul) și confirmă eliminarea a doua oară.
Prin API
Încărcarea sau înlocuirea logo-ului
POST /v1/codes/{id}/logo – cerere multipart, câmpul file.
curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \ -H "Authorization: Bearer qr3_sk_..." \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
Toate cele patru formate – qr.svg, qr.png, qr.pdf și qr.eps – încorporează pixelii reali ai logo-ului în centru, scalați la o proporție fixă din suprafața codului. Toate cele patru cresc corecția erorilor la H pentru ca codul să rămână scanabil.
Cache
Atunci când este setat un logo, toate cele patru formate – qr.svg, qr.png, qr.pdf și qr.eps – 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ă logo-ul însuși trebuie să apară pe materialul tipărit, tipărește din nou cu unul dintre cele patru formate actuale (
qr.svg,qr.png,qr.pdfsauqr.eps) – nu amesteca 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 imagine nouă dorită, nu de scanabilitate.
- Toate cele patru formate conțin acum logo-ul în mod egal – programul de machetare decide singur care format este potrivit pentru propriul tău șablon de tipărire (vector pentru PDF/EPS, raster pentru PNG, SVG pentru ambele).
- Înainte de un tiraj complet de tipărire, efectuează întotdeauna o scanare de probă pe materialul real, în special după o modificare a modelului, și nu amesteca niciodată fișiere din versiuni diferite.