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 į atsisiunčiamus SVG ir PNG failus; PDF ir EPS failuose jo niekada nebūna.

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

qr.svg ir qr.png įterpia tikruosius logotipo pikselius centre, mastelį pritaikant prie fiksuotos kodo ploto dalies. Abu failai tam padidina klaidų taisymą iki H, kad kodas išliktų nuskaitomas. qr.pdf ir qr.eps logotipas neturi jokios įtakos – juose logotipas niekada neįterpiamas ir išlaikomas toks pat raštas, koks būtų ir be logotipo.

Talpykla (Cache)

Kai logotipas nustatytas, qr.svg/qr.png 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 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 naujausią qr.svg arba qr.png failą – niekada nemaišykite senų ir naujų spaudos failų.
  • Logotipo pakeitimas nekeičia rašto; spausdinimas iš naujo tokiu atveju reikalingas tik norint parodyti naują vaizdą, o ne dėl nuskaitomumo.
  • qr.pdf ir qr.eps failuose logotipo niekada nebūna. Spaudos šablonams, kuriuose turi matytis logotipas, atsisiųskite qr.svg arba qr.png.
  • Prieš pradedant spausdinti visą tiražą, visada atlikite bandomąjį nuskaitymą ant tikros medžiagos, ypač po rašto pakeitimo.

Susiję