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 alla fyra nedladdningar: SVG, PNG, PDF och EPS.

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

Alla fyra formaten – qr.svg, qr.png, qr.pdf och qr.eps – bäddar in logotypens faktiska pixlar centrerat, skalat till en fast andel av kodens yta. Alla fyra höjer felkorrigeringen till H för att koden ska förbli skanningsbar.

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 alla fyra formaten – qr.svg, qr.png, qr.pdf och qr.eps – med Cache-Control: public, max-age=300 (5 minuter) istället för det annars 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, 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 själv ska visas på tryckmaterialet, tryck om med ett av de fyra aktuella formaten (qr.svg, qr.png, qr.pdf eller qr.eps) – blanda aldrig gamla och nya tryckfiler.
• Att ersätta en logotyp ändrar inte mönstret; ett omtryck är då endast en fråga om den önskade nya bilden, inte om skanningsbarheten.
• Alla fyra formaten innehåller nu logotypen i lika stor utsträckning – vilket format som lämpar sig för den egna tryckmallen avgörs enbart av layoutprogrammet (vektor för PDF/EPS, raster för PNG, SVG för båda).
• Gör alltid en testskanning på det verkliga materialet före en fullständig tryckning, särskilt efter en mönsterändring, och blanda aldrig filer från olika versioner.

Relaterat

• Nedladdningsformat
• Filer & datablad