Skip to content
qr3.app Docs

Logo u QR kodu

Kod može sadržavati neobavezni logo u svom središtu – vlastiti brend umjesto čistog QR uzorka. Logo se ugrađuje kao stvarni pikseli u preuzimanja u formatima SVG i PNG; PDF i EPS ga nikada ne sadrže.

Na Nadzornoj ploči

Otvorite stranicu s pojedinostima koda. Pokraj pregleda QR koda i gumba za preuzimanje nalazi se kartica Logo u QR kodu.

  1. Kliknite na Odaberi logo i odaberite PNG, JPEG ili WebP datoteku (najviše 1 MB – veći ili drugi formati, uključujući SVG, bit će odbijeni i prije prijenosa).
  2. Pojavljuje se pregled odabrane datoteke zajedno s napomenom:
    • Logo još ne postoji – dodavanje mijenja točkasti uzorak koda. Označite kvačicu za potvrdu, a zatim kliknite na Prenesi logo.
    • Logo je već postavljen – zamjena mijenja samo sliku u sredini, uzorak ostaje isti. Kliknite na Zamijeni logo; potvrda nije potrebna.
  3. Za uklanjanje kliknite na Ukloni logo, potvrdite kvačicu upozorenja (uklanjanje također mijenja uzorak) i potvrdite uklanjanje po drugi put.

Putem API-ja

Prijenos ili zamjena logotipa

POST /v1/codes/{id}/logo – Multipart-Request, 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): ažurirani kod, s postavljenim logo_file_id.

Datoteka se provjerava na temelju svojih čarobnih bajtova (Magic Bytes), a ne na temelju ekstenzije ili zaglavlja Content-Type. Normalizira se u prozirni PNG dimenzija 512 × 512 px (uz očuvanje omjera stranica). Postojeći logo se zamjenjuje – po kodu uvijek postoji samo jedan logo.

Uklanjanje logotipa

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

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

Odgovor (HTTP 200): ažurirani kod, logo_file_id ponovno postavljen na null. Idempotentno – poziv bez postojećeg logotipa i dalje vraća 200 i ne mijenja ništa.

Pogreške

StatusKada
403Uloga API ključa je viewer
404Kod nije pronađen u radnom prostoru (Workspace)
413Datoteka je veća od 1 MB
422Nedostaje polje file ili je format različit od PNG/JPEG/WebP (uključujući SVG)

Što se mijenja na kodu

qr.svg i qr.png ugrađuju stvarne piksele logotipa centrirano, skalirane na fiksni udio površine koda. Oba formata zbog toga podižu ispravljanje pogrešaka na H kako bi kod ostao skenirljiv. qr.pdf i qr.eps nisu zahvaćeni logotipom – oni ga nikada ne ugrađuju i zadržavaju uzorak koji bi imali i bez logotipa.

Predmemorija (Cache)

S postavljenim logotipom, qr.svg/qr.png isporučuju se s Cache-Control: public, max-age=300 (5 minuta) umjesto uobičajenog public, max-age=86400, immutable (24 sata). URL slike ugrađen na drugom mjestu – na stranici, u e-pošti, u dokumentu – stoga preuzima promjenu logotipa u roku od najviše 5 minuta. Kopiji koja je predmemorirana prije nego što je kod uopće imao logo može trebati i do puna 24 sata jer je predmemorirana s dužim, nepromjenjivim vijekom trajanja.

Ispis

  • Već ispisani kod nastavlja raditi, bez obzira na to je li logo dodan, zamijenjen ili uklonjen – kodirano odredište nikada ne ovisi o logotipu.
  • Dodavanje ili uklanjanje logotipa mijenja točkasti uzorak. Ako se sam logo treba pojaviti na tiskanom materijalu, ponovno ispišite s trenutačnim qr.svg oder qr.png – pritom nikada ne miješajte stare i nove datoteke za ispis.
  • Zamjena logotipa ne mijenja uzorak; ponovni ispis u tom je slučaju samo pitanje željene nove slike, a ne skenirljivosti.
  • qr.pdf i qr.eps nikada ne sadrže logo. Za predloške za ispis koji trebaju prikazivati logo, preuzmite qr.svg ili qr.png.
  • Prije pokretanja cjelokupne naklade ispisa uvijek napravite probno skeniranje na stvarnom materijalu, osobito nakon promjene uzorka.

Povezano