Preskočiť na obsah
qr3.app Docs

Logo v QR kóde

Kód môže mať v strede voliteľné logo – vlastnú značku namiesto čistého QR vzoru. Logo sa vloží ako skutočné pixely do stiahnutých súborov SVG a PNG; PDF a EPS ho nikdy neobsahujú.

V Dashboarde

Otvorte detailnú stránku kódu. Vedľa náhľadu QR kódu a tlačidiel na stiahnutie sa nachádza karta Logo v QR kóde.

  1. Kliknite na Vybrať logo a vyberte súbor PNG, JPEG alebo WebP (maximálne 1 MB – väčšie alebo iné formáty, vrátane SVG, budú odmietnuté ešte pred nahraním).
  2. Zobrazí sa náhľad vybraného súboru spolu s upozornením:
    • Logo zatiaľ nie je nastavené – pridanie zmení bodový vzor kódu. Začiarknite políčko na potvrdenie a potom kliknite na Nahrať logo.
    • Logo je už nastavené – nahradenie vymení iba obrázok v strede, vzor zostane rovnaký. Kliknite na Nahradiť logo; potvrdenie nie je potrebné.
  3. Pre odstránenie kliknite na Odstrániť logo, potvrďte varovné začiarkavacie políčko (aj odstránenie zmení vzor) a potvrďte odstránenie druhýkrát.

Cez API

Nahranie alebo nahradenie loga

POST /v1/codes/{id}/logo – Multipart request, pole file.

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

Odpoveď (HTTP 201): aktualizovaný kód s nastaveným logo_file_id.

Súbor sa kontroluje na základe jeho magic bytes, nie podľa prípony alebo Content-Type. Normalizuje sa na transparentné PNG s rozmermi 512 × 512 px (pomer strán zostane zachovaný). Existujúce logo sa nahradí – pre každý kód existuje vždy iba jedno logo.

Odstránenie loga

DELETE /v1/codes/{id}/logo – bez tela (body).

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

Odpoveď (HTTP 200): aktualizovaný kód, logo_file_id je opäť nastavené na null. Idempotentné – volanie bez existujúceho loga naďalej vracia 200 a nič nemení.

Chyby

StatusKedy
403Rola API kľúča je viewer
404Kód sa vo workspace nenašiel
413Súbor je väčší ako 1 MB
422Chýba pole file alebo ide o iný formát ako PNG/JPEG/WebP (vrátane SVG)

Čo sa na kóde mení

qr.svg a qr.png vkladajú skutočné pixely loga vycentrované, skálované na pevný podiel plochy kódu. Obidva formáty preto zvyšujú korekciu chýb na H, aby kód zostal skenovateľný. qr.pdf a qr.eps nie sú logom ovplyvnené – nikdy ho nevkladajú a zachovávajú si vzor, ktorý by mali aj bez loga.

Cache

S nastaveným logom sa qr.svg/qr.png doručujú s hlavičkou Cache-Control: public, max-age=300 (5 minút) namiesto bežných public, max-age=86400, immutable (24 hodín). URL adresa obrázka vložená inde – na stránke, v e-maile, v dokumente – tak prevezme zmenu loga do 5 minút. Kópia, ktorá bola uložená do vyrovnávacej pamäte predtým, ako kód vôbec mal nejaké logo, môže potrebovať až celých 24 hodín, pretože bola nacachovaná s dlhšou, nezmeniteľnou životnosťou.

Tlač

  • Už vytlačený kód funguje ďalej, bez ohľadu na to, či sa logo pridá, nahradí alebo odstráni – kódovaný cieľ nikdy nezávisí od loga.
  • Pridanie alebo odstránenie loga mení bodový vzor. Ak sa má samotné logo objaviť na tlačenom materiáli, vytlačte ho znova pomocou aktuálneho qr.svg alebo qr.png – nikdy pritom nemiešajte staré a nové tlačové súbory.
  • Nahradenie loga nemení vzor; dotlač je potom len otázkou požadovaného nového obrázka, nie skenovateľnosti.
  • qr.pdf a qr.eps nikdy neobsahujú logo. Pre tlačové podklady, ktoré majú zobrazovať logo, si stiahnite qr.svg alebo qr.png.
  • Pred spustením celého tlačového nákladu vždy urobte skúšobný sken na skutočnom materiáli, najmä po zmene vzoru.

Súvisiace