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 všetkých štyroch stiahnutých súborov: SVG, PNG, PDF a EPS.
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.
- 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).
- 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é.
- 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.
curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \ -H "Authorization: Bearer qr3_sk_..." \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).
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
| Status | Kedy |
|---|---|
| 403 | Rola API kľúča je viewer |
| 404 | Kód sa vo workspace nenašiel |
| 413 | Súbor je väčší ako 1 MB |
| 422 | Chýba pole file alebo ide o iný formát ako PNG/JPEG/WebP (vrátane SVG) |
Čo sa na kóde mení
Všetky štyri formáty – qr.svg, qr.png, qr.pdf a qr.eps – vkladajú skutočné pixely loga vycentrované, skálované na pevný podiel plochy kódu. Všetky štyri preto zvyšujú korekciu chýb na H, aby kód zostal skenovateľný.
Cache
S nastaveným logom sa všetky štyri formáty – qr.svg, qr.png, qr.pdf a
qr.eps – doručujú s hlavičkou Cache-Control: public, max-age=300 (5 minút)
namiesto inak 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 jedného zo štyroch aktuálnych formátov (
qr.svg,qr.png,qr.pdfaleboqr.eps) – 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.
- Všetky štyri formáty teraz obsahujú logo rovnako – o tom, ktorý formát je vhodný pre vašu vlastnú tlačovú predlohu, rozhoduje výlučne layoutový program (vektor pre PDF/EPS, raster pre PNG, SVG pre oboje).
- 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, a nikdy nemiešajte súbory z rôznych stavov.