Logo v QR kódu

Kód může mít uprostřed volitelné logo – vlastní značku namísto pouhého QR vzoru. Logo se vloží jako skutečné pixely do všech čtyř stažených souborů: SVG, PNG, PDF a EPS.

V Dashboardu

Otevřete stránku s podrobnostmi kódu. Vedle náhledu QR kódu a tlačítek pro stažení se nachází karta Logo v QR kódu.

Klikněte na Vybrat logo a zvolte soubor ve formátu PNG, JPEG nebo WebP (maximálně 1 MB – větší nebo jiné formáty, včetně SVG, budou odmítnuty ještě před nahráním).
Zobrazí se náhled vybraného souboru spolu s upozorněním:
- Logo zatím není nastaveno – přidání změní bodový vzor kódu. Zaškrtněte políčko pro potvrzení a poté klikněte na Nahrát logo.
- Logo je již nastaveno – nahrazení pouze vymění obrázek uprostřed, vzor zůstane stejný. Klikněte na Nahradit logo; potvrzení není nutné.
Pro odstranění klikněte na Odebrat logo, potvrďte varovné zaškrtávací políčko (i odstranění mění vzor) a potvrďte odstranění podruhé.

Přes API

Nahrání nebo nahrazení loga

POST /v1/codes/{id}/logo – multipart požadavek, pole file.

cURL

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

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

Soubor je kontrolován na základě svých „magic bytes“, nikoli podle přípony nebo hlavičky Content-Type. Je normalizován na průhledné PNG o rozměrech 512 × 512 px (poměr stran zůstává zachován). Stávající logo se nahradí – pro každý kód existuje vždy pouze jedno logo.

Odebrání loga

DELETE /v1/codes/{id}/logo – bez těla (body).

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

Odpověď (HTTP 200): aktualizovaný kód, logo_file_id je opět nastaveno na null. Idempotentní – volání bez existujícího loga stále vrací 200 a nic nemění.

Chyby

Status	Kdy
403	Role API klíče je `viewer`
404	Kód nebyl ve Workspace nalezen
413	Soubor je větší než 1 MB
422	Chybí pole `file` nebo jde o jiný formát než PNG/JPEG/WebP (včetně SVG)

Co se na kódu mění

Všechny čtyři formáty – qr.svg, qr.png, qr.pdf a qr.eps – vkládají skutečné pixely loga vycentrovaně, škálované na pevný podíl plochy kódu. Všechny čtyři kvůli tomu zvyšují opravu chyb na H, aby kód zůstal skenovatelný.

Cache

S nastaveným logem jsou všechny čtyři formáty – qr.svg, qr.png, qr.pdf a qr.eps – doručovány s hlavičkou Cache-Control: public, max-age=300 (5 minut) namísto obvyklých public, max-age=86400, immutable (24 hodin). URL adresa obrázku vložená jinde – na stránce, v e-mailu, v dokumentu – tak převezme změnu loga během maximálně 5 minut. Kopie, která byla nacachována předtím, než kód vůbec nějaké logo měl, může vyžadovat až celých 24 hodin, protože byla uložena s delší, neměnnou dobou platnosti.

Tisk

Již vytištěný kód funguje i nadále, bez ohledu na to, zda je logo přidáno, nahrazeno nebo odebráno – kódovaný cíl nikdy nezávisí na logu.
Přidání nebo odebrání loga mění bodový vzor. Pokud se má logo samo objevit na tiskovém materiálu, vytiskněte jej znovu s jedním ze čtyř aktuálních formátů (qr.svg, qr.png, qr.pdf nebo qr.eps) – staré a nové tiskové soubory přitom nikdy nemíchejte.
Nahrazení loga nemění vzor; nový tisk je pak pouze otázkou požadovaného nového obrázku, nikoli skenovatelnosti.
Všechny čtyři formáty nyní obsahují logo stejnou měrou – o tom, který formát se hodí pro vaši tiskovou šablonu, rozhoduje výhradně sázecí program (vektor pro PDF/EPS, rastr pro PNG, SVG pro obojí).
Před kompletním tiskovým nákladem vždy proveďte zkušební sken na reálném materiálu, zejména po změně vzoru, a nikdy nemíchejte soubory z různých stavů.