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 vseh štirih prenosih: SVG, PNG, PDF in EPS.

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

Vsi štirje formati – qr.svg, qr.png, qr.pdf in qr.eps – vdelajo dejanske slikovne pike logotipa na sredino, skalirane na fiksni delež površine kode. Vsi štirje za to zvišajo raven popravljanja napak na H, da koda ostane skenirljiva.

Predpomnilnik

Z nastavljenim logotipom se vsi štirje formati – qr.svg, qr.png, qr.pdf in qr.eps – dostavljajo 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 sam pojaviti na tiskanem materialu, ponovno natisnite z enim od štirih trenutnih formatov (qr.svg, qr.png, qr.pdf ali qr.eps) – 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.
  • Vsi štirje formati zdaj enako vsebujejo logotip – kateri format je primeren za vašo lastno tiskarsko predlogo, odloča izključno program za postavitev (vektor za PDF/EPS, raster za PNG, SVG za oboje).
  • Pred celotno naklado tiskanja vedno opravite testno skeniranje na dejanskem materialu, zlasti po spremembi vzorca, in nikoli ne mešajte datotek iz različnih stanj.

Sorodno