Gå til indhold
qr3.app Docs

Logo i QR-koden

En kode kan have et valgfrit logo i midten – dit eget brand i stedet for et rent QR-mønster. Logoet indlejres som faktiske pixels i SVG- og PNG-downloads; PDF og EPS indeholder det aldrig.

I Dashboard

Åbn detaljesiden for en kode. Ved siden af QR-forhåndsvisningen og download-knapperne finder du kortet Logo i QR-kode.

  1. Klik på Vælg logo og vælg en PNG-, JPEG- oder WebP-fil (maksimalt 1 MB – større eller andre formater, herunder SVG, afvises allerede før upload).
  2. En forhåndsvisning af den valgte fil vises sammen med en besked:
    • Intet logo endnu – tilføjelsen ændrer kodens punktmønster. Marker afkrydsningsfeltet for at bekræfte, og klik derefter på Upload logo.
    • Der er allerede sat et logo – en udskiftning erstatter kun billedet i midten, mønsteret forbliver det samme. Klik på Erstat logo; det er ikke nødvendigt at bekræfte.
  3. For at fjerne det, klik på Fjern logo, bekræft advarselsfeltet (fjernelse ændrer også mønsteret) og bekræft fjernelsen en ekstra gang.

Via API

POST /v1/codes/{id}/logo – Multipart-anmodning, feltet file.

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

Svar (HTTP 201): den opdaterede kode med logo_file_id sat.

Filen kontrolleres ud fra dens magic bytes, ikke ud fra filendelsen eller Content-Type. Den normaliseres til en gennemsigtig PNG på 512 × 512 px (højde-bredde-forhold bevares). Et eksisterende logo erstattes – der er altid kun ét logo pr. kode.

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

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

Svar (HTTP 200): den opdaterede kode, hvor logo_file_id igen er sat til null. Idempotent – et kald uden et eksisterende logo returnerer stadig 200 og ændrer intet.

Fejl

StatusHvornår
403API-nøglens rolle er viewer
404Koden blev ikke fundet i workspacet
413Filen er større end 1 MB
422Feltet file mangler, oder et andet format end PNG/JPEG/WebP (herunder SVG)

Hvad der ændrer sig ved koden

qr.svg og qr.png indlejrer logoets faktiske pixels centreret, skaleret til en fast andel af kodearealet. Begge hæver til dette formål fejlkorrektionen til H, så koden forbliver scannbar. qr.pdf og qr.eps påvirkes ikke af et logo – de indlejrer aldrig et og beholder det mønster, de også ville have uden et logo.

Cache

Når et logo er sat, leveres qr.svg/qr.png med Cache-Control: public, max-age=300 (5 minutter) i stedet for den ellers sædvanlige public, max-age=86400, immutable (24 timer). En billed-URL, der er indlejret et andet sted – på side, i en e-mail, i et dokument – vil derfor afspejle en logoændring inden for op til 5 minutter. En kopi, der blev cachet, før en kode overhovedet havde et logo, kan tage op til hele 24 timer, fordi den blev cachet med den længere, uforanderlige levetid.

Tryk

  • En allerede trykt kode fungerer fortsat, uanset om et logo tilføjes, erstattes eller fjernes – den kodede destination afhænger aldrig af logoet.
  • Tilføjelse oder fjernelse af et logo ændrer punktmønsteret. Hvis selve logoet skal vises på det trykte materiale, skal der trykkes på ny med den aktuelle qr.svg eller qr.png – bland aldrig gamle og nye trykfiler.
  • Udskiftning af et logo ændrer ikke mønsteret; et nyt tryk er i så fald kun et spørgsmål om det ønskede nye billede, ikke om scanbarheden.
  • qr.pdf og qr.eps indeholder aldrig et logo. Til trykskabeloner, der skal vise logoet, skal du downloade qr.svg eller qr.png.
  • Før et fuldt trykoplag skal du altid foretage en testscanning på det rigtige materiale, især efter en mønsterændring.

Relateret