Skip to content
qr3.app Docs

Logotipas QR kode

Kodas jo viduryje gali turėti neprivalomą logotipą – jūsų prekės ženklą vietoj gryno QR kodo rašto. Logotipas įterpiamas kaip tikri pikseliai į visus keturis atsisiunčiamus failus: SVG, PNG, PDF ir EPS.

Valdymo skydelyje

Atidarykite kodo išsamios informacijos puslapį. Šalia QR peržiūros ir atsisiuntimo mygtukų yra kortelė Logotipas QR kode.

  1. Spustelėkite Pasirinkti logotipą ir pasirinkite PNG, JPEG arba WebP failą (ne didesnį kaip 1 MB – didesni ar kitų formatų failai, įskaitant SVG, atmetami dar prieš įkeliant).
  2. Pasirodys pasirinkto failo peržiūra kartu su pranešimu:
    • Logotipo dar nėra – pridėjus logotipą, pasikeis kodo taškų raštas. Pažymėkite varnelę patvirtinimui, tada spustelėkite Įkelti logotipą.
    • Logotipas jau nustatytas – pakeitus logotipą, pakeičiamas tik viduryje esantis vaizdas, o raštas lieka toks pat. Spustelėkite Pakeisti logotipą; patvirtinimo nereikia.
  3. Norėdami pašalinti, spustelėkite Pašalinti logotipą, pažymėkite įspėjamąją varnelę (pašalinimas taip pat keičia raštą) ir patvirtinkite pašalinimą antrą kartą.

Per API

Logotipo įkėlimas arba pakeitimas

POST /v1/codes/{id}/logo – Multipart užklausa, laukas file.

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

Atsakymas (HTTP 201): atnaujintas kodas su nustatytu logo_file_id.

Failas tikrinamas pagal jo „stebuklinguosius baitus“ (magic bytes), o ne pagal plėtinį ar Content-Type. Jis normalizuojamas į permatomą PNG failą, kurio dydis 512 × 512 px (išlaikant kraštinių santykį). Esamas logotipas pakeičiamas – vienam kodui visada gali būti tik vienas logotipas.

Logotipo pašalinimas

DELETE /v1/codes/{id}/logo – be užklausos kūno (body).

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

Atsakymas (HTTP 200): atnaujintas kodas, logo_file_id vėl nustatytas į null. Idempotentinis – užklausa be esamo logotipo vis tiek grąžina 200 ir nieko nekeičia.

Klaidos

BūsenaKada
403API rakto rolė yra viewer
404Kodas nerastas darbo srityje (workspace)
413Failas yra didesnis nei 1 MB
422Trūksta lauko file arba formatas skiriasi nuo PNG/JPEG/WebP (įskaitant SVG)

Kas keičiasi kode

Visi keturi formatai – qr.svg, qr.png, qr.pdf ir qr.eps – įterpia tikruosius logotipo pikselius centre, mastelį pritaikant prie fiksuotos kodo ploto dalies. Visi keturi tam padidina klaidų taisymą iki H, kad kodas išliktų nuskaitomas.

Talpykla (Cache)

Kai logotipas nustatytas, visi keturi formatai – qr.svg, qr.png, qr.pdf ir qr.eps – pateikiami su Cache-Control: public, max-age=300 (5 minutės) vietoj įprasto public, max-age=86400, immutable (24 valandos). Todėl kitur įterptas vaizdo URL adresas – puslapyje, el. laiške, dokumente – logotipo pakeitimą pritaikys per ne daugiau kaip 5 minutes. Kopijai, kuri buvo išsaugota talpykloje prieš kodui išvis gaunant logotipą, gali prireikti iki pilnų 24 valandų, nes ji buvo įrašyta į talpyklą su ilgesniu, nekintamu galiojimo laiku.

Spausdinimas

  • Jau atspausdintas kodas veikia toliau, nepriklausomai nuo to, ar logotipas pridedamas, pakeičiamas ar pašalinamas – užkoduotas tikslas niekada nepriklauso nuo logotipo.
  • Logotipo pridėjimas arba pašalinimas pakeičia taškų raštą. Jei pats logotipas turi matytis ant spausdinamos medžiagos, spausdinkite iš naujo naudodami vieną iš keturių dabartinių formatų (qr.svg, qr.png, qr.pdf arba qr.eps) – niekada nemaišykite senų ir naujų spaudos failų.
  • Logotipo pakeitimas nekeičia rašto; spausdinimas iš naujo tokiu atveju yra tik norimo naujo vaizdo, o ne nuskaitomumo klausimas.
  • Visi keturi formatai dabar vienodai apima logotipą – kuris formatas tinka jūsų spaudos šablonui, priklauso tik nuo maketavimo programos (vektorinis PDF/EPS formatui, rastrinis PNG formatui, SVG abiem).
  • Prieš pradedant spausdinti visą tiražą, visada atlikite bandomąjį nuskaitymą ant tikros medžiagos, ypač po rašto pakeitimo, ir niekada nemaišykite skirtingų versijų failų.

Susiję