Skip to content
qr3.app Docs

Logo QR-koodis

Koodi keskele saab lisada valikulise logo – oma brändi puhta QR-mustri asemel. Logo lisatakse tegelike pikslitena SVG- ja PNG-allalaadimistesse; PDF ja EPS ei sisalda seda kunagi.

Dashboardis

Ava koodi detailvaade. QR-koodi eelvaate ja allalaadimisnuppude kõrval asub kaart Logo QR-koodis.

  1. Klõpsa nupule Vali logo ja vali PNG-, JPEG- või WebP-fail (maksimaalselt 1 MB – suuremad või muud vormingud, sealhulgas SVG, lükatakse tagasi juba enne üleslaadimist).
  2. Kuvatakse valitud faili eelvaade koos märguandega:
    • Logo pole veel määratud – lisamine muudab koodi punktimustrit. Märgi linnuke kinnitamiseks ja klõpsa seejärel Laadi logo üles.
    • Logo on juba määratud – asendamine vahetab ainult keskel oleva pildi, muster jääb samaks. Klõpsa Asenda logo; kinnitust pole vaja.
  3. Eemaldamiseks klõpsa Eemalda logo, kinnita hoiatuse märkeruut (ka eemaldamine muudab mustrit) ja kinnita eemaldamine teist korda.

API kaudu

Logo üleslaadimine või asendamine

POST /v1/codes/{id}/logo – mitmeosaline päring (multipart), väli file.

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

Vastus (HTTP 201): uuendatud kood, kus on määratud logo_file_id.

Faili kontrollitakse selle maagiliste baitide (magic bytes) järgi, mitte faililaiendi või päise Content-Type põhjal. See normaliseeritakse läbipaistvaks PNG-failiks mõõtmetega 512 × 512 px (säilitades kuvasuhte). Olemasolev logo asendatakse – igal koodil saab korraga olla ainult üks logo.

Logo eemaldamine

DELETE /v1/codes/{id}/logo – ilma päringu kehata (body).

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

Vastus (HTTP 200): uuendatud kood, kus logo_file_id on uuesti väärtusega null. Idempotentne – päring ilma olemasoleva logota tagastab samuti 200 ega muuda midagi.

Tõrked

OlekukoodMillal
403API-võtme roll on viewer
404Koodi ei leitud tööruumist (workspace)
413Fail on suurem kui 1 MB
422Väli file puudub või on tegemist muu vorminguga kui PNG/JPEG/WebP (sealhulgas SVG)

Mis koodis muutub

qr.svg ja qr.png sisaldavad logo tegelikke piksleid keskele joondatuna, skaleerituna kindlale osale koodi pindalast. Mõlemad tõstavad selleks veaparanduse tasemele H, et kood jääks skannitavaks. qr.pdf ja qr.eps failidele logo ei avalda mõju – need ei sisalda kunagi logo ja säilitavad mustri, mis neil oleks ka ilma logota.

Vahemälu

Kui logo on määratud, väljastatakse qr.svg/qr.png päisega Cache-Control: public, max-age=300 (5 minutit) tavapärase public, max-age=86400, immutable (24 tundi) asemel. Mujale sisse seatud pildi URL – veebilehel, e-kirjas, dokumendis – kajastab logo muutust seega kuni 5 minuti jooksul. Koopia, mis salvestati vahemällu enne, kui koodil üldse logo oli, võib vajada kuni 24 tundi, kuna see salvestati pikema ja muutumatu elueaga.

Printimine

  • Juba prinditud kood töötab edasi, olenemata sellest, kas logo lisatakse, asendatakse või eemaldatakse – kodeeritud sihtkoht ei sõltu kunagi logost.
  • Logo lisamine või eemaldamine muudab punktimustrit. Kui logo peab trükisel näha olema, printige uuesti, kasutades uusimat qr.svg oder qr.png faili – ärge kunagi segage omavahel vanu ja uusi trükifaile.
  • Logo asendamine ei muuda mustrit; uuesti printimine on sel juhul vaid soovitud uue pildi, mitte skannitavuse küsimus.
  • qr.pdf ja qr.eps ei sisalda kunagi logo. Trükimallide jaoks, mis peavad logo näitama, laadige alla qr.svg või qr.png.
  • Enne kogu tiraaži trükkimist tehke alati testskannimine tegelikul materjalil, eriti pärast mustri muutumist.

Seotud teemad