Logó a QR-kódban

Egy kód opcionálisan tartalmazhat egy logót a közepén – a saját márkát a puszta QR-minta helyett. A logó tényleges képpontokként ágyazódik be mind a négy letöltésbe: SVG, PNG, PDF és EPS.

Note

A logó a kód hibajavítási szintjét H szintre emeli, hogy a minta részben eltakart kép esetén is beolvasható maradjon. Hogy ez mit jelent a már kinyomtatott kódok esetében, az alábbi, Nyomtatás című szakaszban olvasható.

A Dashboardon

Nyisd meg egy kód részletes oldalát. A QR-előnézet és a letöltési gombok mellett található a Logó a QR-kódban kártya.

1. Kattints a Logó kiválasztása gombra, és válassz ki egy PNG-, JPEG- vagy WebP-fájlt (legfeljebb 1 MB – a nagyobb vagy más formátumokat, beleértve az SVG-t is, a rendszer már a feltöltés előtt elutasítja).
2. Megjelenik a kiválasztott fájl előnézete egy figyelmeztetéssel együtt:
   • Még nincs logó beállítva – a hozzáadás megváltoztatja a kód pontmintázatát. Jelöld be a megerősítő négyzetet, majd kattints a Logó feltöltése gombra.
   • Már van beállítva logó – a csere csak a középen lévő képet cseréli ki, a minta változatlan marad. Kattints a Logó cseréje gombra; megerősítés nem szükséges.
3. Az eltávolításhoz kattints a Logó eltávolítása gombra, jelöld be a figyelmeztető négyzetet (az eltávolítás szintén megváltoztatja a mintát), majd erősítsd meg az eltávolítást másodszor is.

Caution

Csak író szerepkörrel rendelkező felhasználó tölthet fel, cserélhet vagy távolíthat el logót. A viewer szerepkör látja az aktuális állapotot, és ha be van állítva logó, a nyomtatási formátumokra vonatkozó megjegyzést is – de a három művelet egyikét sem végezheti el.

API-n keresztül

Logó feltöltése vagy cseréje

POST /v1/codes/{id}/logo – Multipart kérés, file mező.

cURL

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

Válasz (HTTP 201): a frissített kód, beállított logo_file_id értékkel.

A fájl ellenőrzése a mágikus bájtok (magic bytes) alapján történik, nem a kiterjesztés vagy a Content-Type alapján. A rendszer egy 512 × 512 px méretű, átlátszó PNG-vé normalizálja (a képarány megtartásával). A meglévő logó felülíródik – kódonként mindig csak egy logó létezhet.

Logó eltávolítása

DELETE /v1/codes/{id}/logo – törzs (body) nélkül.

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

Válasz (HTTP 200): a frissített kód, a logo_file_id ismét null értékre állítva. Idempotens – a meglévő logó nélküli hívás szintén 200-at ad vissza, és nem változtat semmit.

Hibák

Státusz	Mikor
403	Az API-kulcs szerepköre viewer
404	A kód nem található a munkaterületen (Workspace)
413	A fájl nagyobb, mint 1 MB
422	A file mező hiányzik, vagy a formátum nem PNG/JPEG/WebP (beleértve az SVG-t is)

Mi változik a kódban

Mind a négy formátum – a qr.svg, a qr.png, a qr.pdf és a qr.eps – a logó tényleges képpontjait ágyazza be középre igazítva, a kódterület egy rögzített arányára méretezve. Mind a négy H szintre emeli a hibajavítást, hogy a kód beolvasható maradjon.

Tip

Egy logó hozzáadása (ha korábban nem volt beállítva) vagy teljes eltávolítása megváltoztatja a kód pontmintázatát (hibajavítás M ↔ H). Ezzel szemben egy meglévő logó másik képre való lecserélése nem változtatja meg a mintát – a hibajavítás H marad, csak a beágyazott képpontok változnak, a mátrix azonos marad.

Gyorsítótár (Cache)

Beállított logó esetén mind a négy formátum – qr.svg, qr.png, qr.pdf és qr.eps – a Cache-Control: public, max-age=300 (5 perc) fejléccel kerül kiszolgálásra a megszokott public, max-age=86400, immutable (24 óra) helyett. Egy máshová – egy oldalra, e-mailbe vagy dokumentumba – beágyazott kép-URL így legfeljebb 5 percen belül átveszi a logó változását. Az a másolat, amely azelőtt került gyorsítótárazásra, mielőtt a kódnak egyáltalán lett volna logója, akár teljes 24 órát is igénybe vehet, mivel a hosszabb, megváltoztathatatlan élettartammal lett gyorsítótárazva.

Nyomtatás

• Egy már kinyomtatott kód továbbra is működik, függetlenül attól, hogy logót adnak hozzá, cserélnek vagy távolítanak el – a kódolt cél soha nem függ a logótól.
• A logó hozzáadása vagy eltávolítása megváltoztatja a pontmintázatot. Ha azt szeretnéd, hogy maga a logó is megjelenjen a nyomtatott anyagon, nyomtasd újra a négy aktuális formátum egyikével (qr.svg, qr.png, qr.pdf vagy qr.eps) – a régi és az új nyomtatási fájlokat eközben soha ne keverd.
• A logó cseréje nem változtatja meg a mintát; az újbóli nyomtatás ekkor csak a kívánt új kép kérdése, nem pedig a beolvashatóságé.
• Mind a négy formátum egyaránt tartalmazza most már a logót – az, hogy melyik formátum alkalmas a saját nyomtatási sablonodhoz, kizárólag a tördelőprogramtól függ (vektoros a PDF/EPS-hez, raszteres a PNG-hez, SVG mindkettőhöz).
• A teljes nyomtatási példányszám elkészítése előtt mindig végezz próbabeolvasást a valódi anyagon, különösen a mintázat megváltozása után, és soha ne keverd a különböző állapotokból származó fájlokat.

Kapcsolódó témakörök

• Letöltési formátumok
• Fájlok és adatlapok