Logo i QR-koden

En kod kan ha en valfri logotyp i mitten – det egna varumärket istället för bara ett QR-mönster. Logotypen bäddas in som faktiska pixlar i SVG- och PNG-nedladdningarna; PDF och EPS innehåller den aldrig.

Note

En logotyp höjer kodens felkorrigering till nivå H, så att mönstret förblir skanningsbart även om bilden är delvis täckt. Vad detta innebär för redan tryckta koder beskrivs längre ner i avsnittet Tryck.

I Dashboard

Öppna detaljsidan för en kod. Bredvid QR-förhandsvisningen och nedladdningsknapparna finns kortet Logo i QR-koden.

1. Klicka på Välj logotyp och välj en PNG-, JPEG- oder WebP-fil (högst 1 MB – större eller andra format, inklusive SVG, nekas redan före uppladdningen).
2. En förhandsvisning av den valda filen visas tillsammans med ett meddelande:
   • Ingen logotyp finns än – att lägga till en ändrar kodens punktmönster. Markera kryssrutan för att bekräfta, klicka sedan på Ladda upp logotyp.
   • En logotyp är redan inställd – att ersätta den byter bara ut bilden i mitten, mönstret förblir detsamma. Klicka på Ersätt logotyp; ingen bekräftelse behövs.
3. För att ta bort, klicka på Ta bort logotyp, bekräfta varningsrutan (även borttagning ändrar mönstret) och bekräfta borttagningen en andra gång.

Caution

Endast en skrivroll kan ladda upp, ersätta eller ta bort en logotyp. Rollen viewer ser den aktuella statusen och, så snart en logotyp är inställd, informationen om tryckformat – men kan inte utföra någon av de tre åtgärderna.

Via API

Ladda upp eller ersätta logotyp

POST /v1/codes/{id}/logo – Multipart-begäran, fältet file.

cURL

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

Svar (HTTP 201): den uppdaterade koden, med logo_file_id satt.

Filen kontrolleras baserat på dess Magic Bytes, inte på filändelsen eller Content-Type. Den normaliseras till en transparent PNG på 512 × 512 px (bildförhållandet bibehålls). En befintlig logotyp ersätts – det finns alltid bara en logotyp per kod.

Ta bort logotyp

DELETE /v1/codes/{id}/logo – utan body.

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

Svar (HTTP 200): den uppdaterade koden, logo_file_id återställt till null. Idempotent – ett anrop utan befintlig logotyp returnerar fortfarande 200 och ändrar ingenting.

Fel

Status	När
403	API-nyckelns roll är viewer
404	Koden hittades inte i arbetsytan
413	Filen är större än 1 MB
422	Fältet file saknas, eller ett annat format än PNG/JPEG/WebP (inklusive SVG)

Vad som ändras i koden

qr.svg och qr.png bäddar in logotypens faktiska pixlar centrerat, skalat till en fast andel av kodens yta. Båda höjer felkorrigeringen till H för att koden ska förbli skanningsbar. qr.pdf och qr.eps påverkas inte av en logotyp – de bäddar aldrig in någon och behåller det mönster de skulle ha haft även utan logotyp.

Tip

Att lägga till en logotyp där ingen tidigare var inställd, oder att ta bort den helt, ändrar kodens punktmönster (felkorrigering M ↔ H). Att ersätta en befintlig logotyp med en annan bild gör däremot inte det – felkorrigeringen förblir H, endast de inbäddade pixlarna ändras, matrisen förblir identisk.

Cache

När en logotyp är inställd levereras qr.svg/qr.png med Cache-Control: public, max-age=300 (5 minuter) istället för det vanliga public, max-age=86400, immutable (24 timmar). En bild-URL som är inbäddad på annat håll – på en sida, i ett e-postmeddelande, i ett dokument – uppdateras alltså med logotypändringen inom upp till 5 minuter. En kopia som cachelagrades innan en kod någonsin hade en logotyp kan ta upp till hela 24 timmar att uppdateras, eftersom den cachelagrades med den längre, oföränderliga livslängden.

Tryck

• En redan tryckt kod fortsätter att fungera, oavsett om en logotyp läggs till, ersätts eller tas bort – det kodade målet är aldrig beroende av logotypen.
• Att lägga till eller ta bort en logotyp ändrar punktmönstret. Om logotypen ska visas på det tryckta materialet, tryck om med den aktuella qr.svg eller qr.png – blanda aldrig gamla och nya tryckfiler.
• Att ersätta en logotyp ändrar inte mönstret; ett omtryck är då endast en fråga om att få den önskade nya bilden, inte om skanningsbarheten.
• qr.pdf och qr.eps innehåller aldrig en logotyp. För tryckmallar som ska visa logotypen, ladda ner qr.svg eller qr.png.
• Gör alltid en testskanning på det verkliga materialet före en fullständig tryckning, särskilt efter en mönsterändring.

Relaterat

• Nedladdningsformat
• Filer & datablad