Skip to content
qr3.app Docs

Logo QR-koodissa

Koodin keskellä voi olla valinnainen logo – oma brändi pelkän QR-kuvion sijaan. Logo upotetaan todellisina pikseleinä SVG- ja PNG-latauksiin; PDF ja EPS eivät koskaan sisällä sitä.

Dashboardissa

Avaa koodin tietosivu. QR-esikatselun ja latauspainikkeiden vieressä on kortti Logo QR-koodissa.

  1. Napsauta Valitse logo ja valitse PNG-, JPEG- tai WebP-tiedosto (enintään 1 MB – suuremmat tai muut formaatit, mukaan lukien SVG, hylätään jo ennen lataamista).
  2. Valitun tiedoston esikatselu tulee näkyviin yhdessä huomautuksen kanssa:
    • Ei vielä logoa – logon lisääminen muuttaa koodin pistekuviota. Vahvista valintaruutu ja napsauta sitten Lataa logo.
    • Logo on jo asetettu – korvaaminen vaihtaa vain keskellä olevan kuvan, kuvio pysyy samana. Napsauta Korvaa logo; vahvistusta ei tarvita.
  3. Poistaaksesi logon napsauta Poista logo, vahvista varoitusvalintaruutu (myös poistaminen muuttaa kuviota) ja vahvista poisto toisen kerran.

API:n kautta

Logon lataaminen tai korvaaminen

POST /v1/codes/{id}/logo – Multipart-pyyntö, kenttä file.

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

Vastaus (HTTP 201): päivitetty koodi, jossa logo_file_id on asetettu.

Tiedosto tarkistetaan sen Magic Bytes -tunnisteen perusteella, ei tiedostopäätteen tai Content-Type-tyypin mukaan. Se normalisoidaan läpinäkyväksi PNG-tiedostoksi koossa 512 × 512 px (kuvasuhde säilyttäen). Olemassa oleva logo korvataan – koodia kohden voi olla aina vain yksi logo.

Logon poistaminen

DELETE /v1/codes/{id}/logo – ilman runkoa.

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

Vastaus (HTTP 200): päivitetty koodi, logo_file_id palautettu arvoon null. Idempotentti – kutsu ilman olemassa olevaa logoa palauttaa edelleen 200 eikä muuta mitään.

Virheet

TilaMilloin
403API-avaimen rooli on viewer
404Koodia ei löydy työtilasta
413Tiedosto on suurempi kuin 1 MB
422Kenttä file puuttuu, tai muu formaatti kuin PNG/JPEG/WebP (mukaan lukien SVG)

Mikä koodissa muuttuu

qr.svg ja qr.png upottavat logon todelliset pikselit keskitetysti, skaalattuna kiinteään osaan koodin pinta-alasta. Molemmat nostavat tätä varten virheenkorjauksen tasolle H, jotta koodi pysyy skannattavana. qr.pdf ja qr.eps ovat riippumattomia logosta – ne eivät koskaan upota sitä ja säilyttävät kuvion, joka niillä olisi myös ilman logoa.

Välimuisti

Kun logo on asetettu, qr.svg/qr.png toimitetaan otsikkotiedolla Cache-Control: public, max-age=300 (5 minuuttia) tavallisen public, max-age=86400, immutable (24 tuntia) sijaan. Muualla upotettu kuvan URL-osoite – esimerkiksi verkkosivulla, sähköpostissa tai asiakirjassa – päivittää logon muutoksen siten viimeistään 5 minuutin kuluessa. Kopio, joka on tallennettu välimuistiin ennen kuin koodilla oli koskaan logoa, voi vaatia jopa täydet 24 tuntia, koska se tallennettiin välimuistiin pidemmällä, muuttumattomalla eliniällä.

Tulostus

  • Jo tulostettu koodi toimii edelleen, riippumatta siitä, lisätäänkö, korvataanko vai poistetaanko logo – koodattu kohde ei koskaan riipu logosta.
  • Logon lisääminen tai poistaminen muuttaa pistekuviota. Jos logon halutaan näkyvän tulostusmateriaalissa, tulosta uudelleen käyttäen uusinta qr.svg- tai qr.png-tiedostoa – älä koskaan sekoita vanhoja ja uusia tulostustiedostoja keskenään.
  • Logon korvaaminen ei muuta kuviota; uudelleentulostus on tällöin vain kysymys halutusta uudesta kuvasta, ei skannattavuudesta.
  • qr.pdf ja qr.eps eivät koskaan sisällä logoa. Jos haluat tulostusmalleihin logon näkyviin, lataa qr.svg tai qr.png.
  • Tee aina koeskannaus aidolle materiaalille ennen lopullista painoerää, erityisesti kuviomuutoksen jälkeen.

Katso myös