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 az SVG és PNG letöltésekbe; a PDF és az EPS formátumok soha nem tartalmazzák.

A Dashboardon

Nyissa 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.

Kattintson a Logó kiválasztása gombra, és válasszon 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).
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ölje be a megerősítő négyzetet, majd kattintson 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. Kattintson a Logó cseréje gombra; megerősítés nem szükséges.
Az eltávolításhoz kattintson a Logó eltávolítása gombra, jelölje be a figyelmeztető négyzetet (az eltávolítás szintén megváltoztatja a mintát), majd erősítse meg az eltávolítást másodszor is.

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

A qr.svg és a qr.png 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. Mindkettő H szintre emeli a hibajavítást, hogy a kód beolvasható maradjon. A qr.pdf és a qr.eps fájlokat nem érinti a logó – ezek soha nem ágyaznak be logót, és megtartják azt a mintát, amellyel logó nélkül is rendelkeznének.

Gyorsítótár (Cache)

Beállított logó esetén a qr.svg/qr.png fájlok a Cache-Control: public, max-age=300 (5 perc) fejléccel kerülnek kiszolgálásra a megszokott public, max-age=86400, immutable (24 óra) helyett. Egy máshová – például egy weboldalra, 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é, hogy maga a logó is megjelenjen a nyomtatott anyagon, nyomtassa újra az aktuális qr.svg oder qr.png fájllal – a régi és az új nyomtatási fájlokat soha ne keverje.
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é.
A qr.pdf és a qr.eps soha nem tartalmaz logót. Az olyan nyomtatási sablonokhoz, amelyeknek mutatniuk kell a logót, töltse le a qr.svg vagy qr.png fájlt.
A teljes nyomtatási példányszám elkészítése előtt mindig végezzen próbabeolvasást a valódi anyagon, különösen a mintázat megváltozása után.