Logo in de QR-code

Een code kann een optioneel logo in het midden bevatten – het eigen merk in plaats van een puur QR-patroon. Het logo wordt als daadwerkelijke pixels in de SVG- en PNG-downloads ingebed; PDF en EPS bevatten het nooit.

Opmerking

Een logo verhoogt de foutcorrectie van de code naar niveau H, zodat het patroon ook met een gedeeltelijk bedekte afbeelding scanbaar blijft. Wat dit betekent voor reeds gedrukte codes, staat verderop in de sectie Drukwerk.

In het Dashboard

Open de detailpagina van een code. Naast de QR-voorbeeldweergave en de downloadknoppen bevindt zich de kaart Logo in de QR-code.

1. Klik op Logo selecteren en kies een PNG-, JPEG- of WebP-bestand (maximaal 1 MB – grotere of andere formaten, inclusief SVG, worden al vóór het uploaden geweigerd).
2. Er verschijnt een voorbeeld van het geselecteerde bestand, samen met een melding:
   • Nog geen logo aanwezig – het toevoegen wijzigt het puntenpatroon van de code. Vinkje bevestigen, daarna op Logo uploaden klikken.
   • Er is al een logo ingesteld – vervangen wisselt alleen de afbeelding in het midden, het patroon blijft hetzelfde. Op Logo vervangen klikken; een bevestiging is niet nodig.
3. Om te verwijderen klik je op Logo verwijderen, bevestig je het waarschuwingsvinkje (ook het verwijderen wijzigt het patroon) en bevestig je de verwijdering een tweede keer.

Opgepast

Alleen een schrijfrol kan een logo uploaden, vervangen of verwijderen. De rol viewer ziet de huidige status en, zodra er een logo is ingesteld, de opmerking over de drukformaten – maar geen van de drie acties.

Via de API

Logo uploaden of vervangen

POST /v1/codes/{id}/logo – multipart-verzoek, veld file.

cURL

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

Antwoord (HTTP 201): de bijgewerkte code, mit ingesteld logo_file_id.

Het bestand wordt gecontroleerd op basis van de magic bytes, niet op basis van de extensie of het Content-Type. Het wordt genormaliseerd naar een transparante PNG van 512 × 512 px (met behoud van de aspectratio). Een bestaand logo wordt vervangen – er is altijd slechts één logo per code.

Logo verwijderen

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

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

Antwoord (HTTP 200): de bijgewerkte code, logo_file_id weer op null ingesteld. Idempotent – een aanroep zonder bestaand logo retourneert nog steeds 200 en verandert niets.

Fouten

Status	Wanneer
403	De rol van de API-key is viewer
404	Code niet gevonden in de workspace
413	Het bestand is groter dan 1 MB
422	Veld file ontbreekt, of een ander formaat dan PNG/JPEG/WebP (inclusief SVG)

Wat er aan de code verandert

qr.svg en qr.png bedden de daadwerkelijke pixels van het logo gecentreerd in, geschaald naar een vast percentage van het codeoppervlak. Beide verhogen hiervoor de foutcorrectie naar H, zodat de code scanbaar blijft. qr.pdf en qr.eps worden niet beïnvloed door een logo – ze bedden er nooit een in en behouden het patroon dat ze ook zonder logo zouden hebben.

Tip

Het toevoegen van een logo waar voorheen geen logo was ingesteld, of het volledig verwijderen ervan, wijzigt het puntenpatroon van de code (foutcorrectie M ↔ H). Het vervangen van een bestaand logo door een andere afbeelding doet dit daarentegen niet – de foutcorrectie blijft H, alleen de ingebedde pixels veranderen, de matrix blijft identiek.

Cache

Met een ingesteld logo worden qr.svg/qr.png geleverd met Cache-Control: public, max-age=300 (5 minuten) in plaats van de anders gebruikelijke public, max-age=86400, immutable (24 uur). Een elders ingebedde afbeeldings-URL – op een pagina, in een e-mail, in een document – neemt een logo-wijziging dus binnen maximaal 5 minuten over. Een kopie die is gecached voordat een code ooit een logo had, kan tot wel 24 uur duren, omdat deze is gecached met de langere, onveranderlijke levensduur.

Drukwerk

• Een reeds gedrukte code blijft werken, ongeacht of er een logo wordt toegevoegd, vervangen of verwijderd – het gecodeerde doel is nooit afhankelijk van het logo.
• Het toevoegen of verwijderen van een logo wijzigt het puntenpatroon. Als het logo zelf op het drukwerk moet verschijnen, druk dan opnieuw af met de actuele qr.svg of qr.png – meng hierbij nooit oude en nieuwe drukbestanden.
• Het vervangen van een logo wijzigt het patroon niet; een herdruk is dan alleen een kwestie van de gewenste nieuwe afbeelding, niet van de scanbaarheid.
• qr.pdf en qr.eps bevatten nooit een logo. Download qr.svg of qr.png voor druksjablonen die het logo moeten tonen.
• Maak vóór een volledige oplage altijd een testscan op het echte materiaal, vooral na een patroonwijziging.

Gerelateerd

• Downloadformaten
• Bestanden & datasheets