Skip to content
qr3.app Docs

Logo QR kodā

Kods var saturēt izvēles logotipu tā centrā – jūsu zīmolu tīra QR raksta vietā. Logotips tiek iegults kā faktiskie pikseļi SVG un PNG lejupielādēs; PDF un EPS faili to nekad nesatur.

Dashboard

Atveriet koda detalizēto lapu. Blakus QR priekšskatījumam un lejupielādes pogām atrodas karte Logo QR kodā.

  1. Noklikšķiniet uz Izvēlēties logotipu un izvēlieties PNG, JPEG vai WebP failu (maksimāli 1 MB – lielāki vai cita formāta faili, ieskaitot SVG, tiks noraidīti vēl pirms augšupielādes).
  2. Parādīsies izvēlētā faila priekšskatījums kopā ar paziņojumu:
    • Logotips vēl nav iestatīts – tā pievienošana mainīs koda punktu rakstu. Atzīmējiet izvēles rūtiņu, lai apstiprinātu, un pēc tam noklikšķiniet uz Augšupielādēt logotipu.
    • Logotips jau ir iestatīts – aizstāšana nomainīs tikai attēlu centrā, raksts paliks nemainīgs. Noklikšķiniet uz Aizstāt logotipu; apstiprinājums nav nepieciešams.
  3. Lai noņemtu, noklikšķiniet uz Noņemt logotipu, apstipriniet brīdinājuma atzīmi (arī noņemšana maina rakstu) un apstipriniet noņemšanu otrreiz.

Izmantojot API

Logotipa augšupielāde vai aizstāšana

POST /v1/codes/{id}/logo – multipart pieprasījums, lauks file.

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

Atbilde (HTTP 201): atjauninātais kods ar iestatītu logo_file_id.

Fails tiek pārbaudīts pēc tā burvju baitiem (magic bytes), nevis pēc paplašinājuma vai Content-Type. Tas tiek normalizēts uz caurspīdīgu PNG ar izmēru 512 × 512 px (saglabājot malu attiecību). Esošais logotips tiek aizstāts – katram kodam vienmēr ir tikai viens logotips.

Logotipa noņemšana

DELETE /v1/codes/{id}/logo – bez ķermeņa (body).

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

Atbilde (HTTP 200): atjauninātais kods, logo_file_id atkal iestatīts uz null. Idempotents – izsaukums bez esoša logotipa joprojām atgriež 200 un neko nemaina.

Kļūdas

StatussKad
403API atslēgas loma ir viewer
404Kods darba vidē (workspace) nav atrasts
413Fails ir lielāks par 1 MB
422Trūkst lauka file vai formāts nav PNG/JPEG/WebP (ieskaitot SVG)

Kas mainās kodā

qr.svg un qr.png iegulst faktiskos logotipa pikseļus centrā, mērogotus līdz noteiktai koda laukuma daļai. Abi šim nolūkam paaugstina kļūdu labošanu līdz H, lai kods paliktu skenējams. qr.pdf un qr.eps logotips neietekmē – tie to nekad neiegulst un saglabā rakstu, kāds tiem būtu bez logotipa.

Kešatmiņa

Ja logotips ir iestatīts, qr.svg/qr.png tiek piegādāti ar Cache-Control: public, max-age=300 (5 minūtes), nevis parasto public, max-age=86400, immutable (24 stundas). Citur iegults attēla URL – lapā, e-pastā, dokumentā – pārņem logotipa izmaiņas 5 minūšu laikā. Kopijai, kas tika saglabāta kešatmiņā pirms kodam vispār bija logotips, var būt nepieciešamas pat pilnas 24 stundas, jo tā tika saglabāta kešatmiņā ar ilgāku, nemainīgu kalpošanas laiku.

Drukāšana

  • Jau izdrukāts kods turpina darboties, neatkarīgi no tā, vai logotips tiek pievienots, aizstāts vai noņemts – kodētais mērķis nekad nav atkarīgs no logotipa.
  • Logotipa pievienošana vai noņemšana maina punktu rakstu. Ja pašam logotipam jāparādās uz drukas materiāla, drukājiet no jauna, izmantojot aktuālo qr.svg vai qr.png – nekad nejauciet vecos un jaunos drukas failus.
  • Logotipa aizstāšana nemaina rakstu; atkārtota drukāšana šādā gadījumā ir tikai vēlamā jaunā attēla jautājums, nevis skenējamības jautājums.
  • qr.pdf un qr.eps nekad nesatur logotipu. Drukas sagatavēm, kurās jāredz logotips, lejupielādējiet qr.svg vai qr.png.
  • Pirms pilnas tirāžas drukāšanas vienmēr veiciet pārbaudes skenēšanu uz reālā materiāla, īpaši pēc raksta izmaiņām.

Saistītā informācija