Logo QR-koodis
Koodi keskele saab lisada valikulise logo – oma brändi puhta QR-mustri asemel. Logo lisatakse tegelike pikslitena kõigis neljas allalaaditavas failis: SVG, PNG, PDF ja EPS.
Dashboardis
Ava koodi detailvaade. QR-koodi eelvaate ja allalaadimisnuppude kõrval asub kaart Logo QR-koodis.
- 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).
- 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.
- 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.
curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \ -H "Authorization: Bearer qr3_sk_..." \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).
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
| Olekukood | Millal |
|---|---|
| 403 | API-võtme roll on viewer |
| 404 | Koodi ei leitud tööruumist (workspace) |
| 413 | Fail on suurem kui 1 MB |
| 422 | Väli file puudub või on tegemist muu vorminguga kui PNG/JPEG/WebP (sealhulgas SVG) |
Mis koodis muutub
Kõik neli formaati – qr.svg, qr.png, qr.pdf ja qr.eps – sisaldavad logo tegelikke piksleid keskele joondatuna, skaleerituna kindlale osale koodi pindalast. Kõik neli tõstavad selleks veaparanduse tasemele H, et kood jääks skannitavaks.
Vahemälu
Kui logo on määratud, väljastatakse kõik neli formaati – qr.svg, qr.png, qr.pdf ja qr.eps – 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 endal näha olema, prindi uuesti, kasutades ühte neljast praegusest formaadist (
qr.svg,qr.png,qr.pdfvõiqr.eps) – ära kunagi sega omavahel vanu ja uusi trükifaile. - Logo asendamine ei muuda mustrit; uuesti printimine on sel juhul vaid soovitud uue pildi, mitte skannitavuse küsimus.
- Kõik neli formaati sisaldavad nüüd logo võrdselt – milline formaat sinu trükimalli jaoks sobib, otsustab ainult küljendusprogramm (vektor PDF/EPS jaoks, raster PNG jaoks, SVG mõlema jaoks).
- Enne kogu tiraaži trükkimist tee alati testskannimine tegelikul materjalil, eriti pärast mustri muutumist, ja ära kunagi sega omavahel erinevatest olekutest pärit faile.