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 visās četrās lejupielādēs: SVG, PNG, PDF un EPS.

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ā

Visi četri formāti – qr.svg, qr.png, qr.pdf un qr.eps – iegulst faktiskos logotipa pikseļus centrā, mērogotus līdz noteiktai koda laukuma daļai. Visi četri šim nolūkam paaugstina kļūdu labošanu līdz H, lai kods paliktu skenējams.

Kešatmiņa

Ja logotips ir iestatīts, visi četri formāti – qr.svg, qr.png, qr.pdf un qr.eps – 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 līdz pat 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 kādu no četriem aktuālajiem formātiem (qr.svg, qr.png, qr.pdf vai qr.eps) – 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.
  • Visi četri formāti tagad satur logotipu vienādā mērā – to, kurš formāts ir piemērots jūsu drukas sagatavei, izlemj tikai maketēšanas programma (vektors priekš PDF/EPS, rasters priekš PNG, SVG abiem).
  • 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, un nekad nejauciet failus no dažādām versijām.

Saistītā informācija