Skip to content
qr3.app Docs

Logotip v kodi QR

Koda lahko v svojem središču vsebuje neobvezen logotip – lastno blagovno znamko namesto samega vzorca QR. Logotip je vdelan kot dejanske slikovne pike v preneseni datoteki SVG in PNG; datoteki PDF in EPS ga nikoli ne vsebujeta.

Na nadzorni plošči

Odprite stran s podrobnostmi kode. Poleg predogleda QR in gumbov za prenos se nahaja kartica Logotip v kodi QR.

  1. Kliknite Izberi logotip in izberite datoteko PNG, JPEG ali WebP (največ 1 MB – večji ali drugi formati, vključno s SVG, bodo zavrnjeni že pred prenosom).
  2. Prikaže se predogled izbrane datoteke skupaj z obvestilom:
    • Logotip še ni nastavljen – dodajanje spremeni točkovni vzorec kode. Potrdite polje in nato kliknite Prenesi logotip.
    • Logotip je že nastavljen – zamenjava zamenja le sliko v sredini, vzorec ostane enak. Kliknite Zamenjaj logotip; potrditev ni potrebna.
  3. Za odstranitev kliknite Odstrani logotip, potrdite opozorilno polje (tudi odstranitev spremeni vzorec) in odstranitev potrdite še drugič.

Prek API-ja

Prenos ali zamenjava logotipa

POST /v1/codes/{id}/logo – večdelna zahteva (multipart), polje file.

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

Odgovor (HTTP 201): posodobljena koda z nastavljenim logo_file_id.

Datoteka se preveri na podlagi njenih čarobnih bajtov (magic bytes), ne pa na podlagi končnice ali glave Content-Type. Normalizira se v prosojni PNG velikosti 512 × 512 px (razmerje stranic se ohrani). Obstoječi logotip se zamenja – za vsako kodo vedno obstaja le en logotip.

Odstranitev logotipa

DELETE /v1/codes/{id}/logo – brez telesa (body).

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

Odgovor (HTTP 200): posodobljena koda, logo_file_id je ponovno nastavljen na null. Idempotentno – klic brez obstoječega logotipa še vedno vrne 200 in ničesar ne spremeni.

Napake

StatusKdaj
403Vloga ključa API je viewer
404Koda v delovnem prostoru ni najdena
413Datoteka je večja od 1 MB
422Polje file manjka ali pa gre za format, ki ni PNG/JPEG/WebP (vključno s SVG)

Kaj se spremeni na kodi

qr.svg in qr.png vdelata dejanske slikovne pike logotipa na sredino, skalirane na fiksni delež površine kode. Obe za to zvišata raven popravljanja napak na H, da koda ostane skenirljiva. Datoteki qr.pdf in qr.eps logotip ne vpliva – nikoli ga ne vdelata in ohranita vzorec, ki bi ga imeli brez logotipa.

Predpomnilnik

Z nastavljenim logotipom se qr.svg/qr.png dostavljata z glavo Cache-Control: public, max-age=300 (5 minut) namesto običajne public, max-age=86400, immutable (24 ur). URL slike, vdelan drugje – na strani, v e-pošti, v dokumentu – bo tako prevzel spremembo logotipa v največ 5 minutah. Kopija, ki je bila predpomnjena, preden je koda sploh imela logotip, pa lahko potrebuje do polnih 24 ur, saj je bila predpomnjena z daljšo, nespremenljivo življenjsko dobo.

Tiskanje

  • Že natisnjena koda deluje naprej, ne glede na to, ali je logotip dodan, zamenjan ali odstranjen – kodirani cilj nikoli ni odvisen od logotipa.
  • Dodajanje ali odstranjevanje logotipa spremeni točkovni vzorec. Če se mora logotip dejansko pojaviti na tiskanem materialu, ponovno natisnite s trenutno datoteko qr.svg ali qr.png – pri tem nikoli ne mešajte starih in novih datotek za tisk.
  • Zamenjava logotipa ne spremeni vzorca; ponovni tisk je v tem primeru le vprašanje želene nove slike, ne pa skenirljivosti.
  • Datoteki qr.pdf in qr.eps nikoli ne vsebujeta logotipa. Za tiskarske predloge, ki naj prikazujejo logotip, prenesite qr.svg ali qr.png.
  • Pred celotno naklado tiskanja vedno opravite testno skeniranje na dejanskem materialu, zlasti po spremembi vzorca.

Sorodno