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 stažených souborů SVG a PNG; PDF a EPS ho nikdy neobsahují.

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í

qr.svg a qr.png vkládají skutečné pixely loga vycentrovaně, škálované na pevný podíl plochy kódu. Obě verze kvůli tomu zvyšují opravu chyb na H, aby kód zůstal skenovatelný. qr.pdf a qr.eps nejsou logem ovlivněny – nikdy ho nevkládají a zachovávají vzor, který by měly i bez loga.

Cache

S nastaveným logem jsou qr.svg/qr.png 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 webu, 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 objevit na tiskovém materiálu, vytiskněte jej znovu s aktuálním qr.svg nebo qr.png – nikdy nemíchejte staré a nové tiskové soubory.
Nahrazení loga nemění vzor; nový tisk je pak pouze otázkou požadovaného nového obrázku, nikoli skenovatelnosti.
qr.pdf a qr.eps nikdy neobsahují logo. Pro tiskové šablony, které mají logo zobrazovat, si stáhněte qr.svg nebo qr.png.
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.