Salta ai contenuti
qr3.app Docs

Logo nel codice QR

Un codice può contenere un logo opzionale al centro – il proprio marchio anziché un semplice motivo QR. Il logo viene incorporato come pixel effettivi nei download SVG e PNG; PDF ed EPS non lo contengono mai.

Nel Dashboard

Apri la pagina dei dettagli di un codice. Accanto all’anteprima del QR e ai pulsanti di download si trova la scheda Logo nel codice QR.

  1. Fai clic su Seleziona logo e scegli un file PNG, JPEG o WebP (massimo 1 MB – formati più grandi o diversi, incluso SVG, vengono rifiutati già prima del caricamento).
  2. Appare un’anteprima del file selezionato insieme a un avviso:
    • Nessun logo ancora presente – l’aggiunta modifica il motivo a punti del codice. Spuntare la casella di conferma, quindi fare clic su Carica logo.
    • Un logo è già impostato – la sostituzione cambia solo l’immagine al centro, il motivo rimane lo stesso. Fare clic su Sostituisci logo; non è necessaria alcuna conferma.
  3. Per rimuoverlo, fare clic su Rimuovi logo, confermare la casella di avviso (anche la rimozione modifica il motivo) e confermare la rimozione una seconda volta.

Tramite API

POST /v1/codes/{id}/logo – richiesta multipart, campo file.

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

Risposta (HTTP 201): il codice aggiornato, con logo_file_id impostato.

Il file viene verificato in base ai suoi magic bytes, non in base all’estensione o al Content-Type. Viene normalizzato in un PNG trasparente di 512 × 512 px (mantenendo le proporzioni). Un logo esistente viene sostituito – è presente sempre un solo logo per codice.

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

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

Risposta (HTTP 200): il codice aggiornato, con logo_file_id reimpostato su null. Idempotente – una chiamata senza un logo esistente restituisce comunque 200 e non modifica nulla.

Errori

StatoQuando
403Il ruolo della chiave API è viewer
404Codice non trovato nel Workspace
413Il file è più grande di 1 MB
422Il campo file manca, oppure formato diverso da PNG/JPEG/WebP (incluso SVG)

Cosa cambia nel codice

qr.svg e qr.png incorporano i pixel effettivi del logo al centro, ridimensionati a una quota fissa dell’area del codice. Entrambi aumentano la correzione dell’errore a H per garantire che il codice rimanga scansionabile. qr.pdf e qr.eps non sono influenzati dal logo – non ne incorporano mai uno e mantengono il motivo che avrebbero anche senza logo.

Cache

Con un logo impostato, qr.svg/qr.png vengono distribuiti con Cache-Control: public, max-age=300 (5 minuti) invece del solito public, max-age=86400, immutable (24 ore). Un URL dell’immagine incorporato altrove – su una pagina, in un’e-mail, in un documento – recepisce quindi una modifica del logo entro un massimo di 5 minuti. Una copia memorizzata nella cache prima che un codice avesse mai un logo può richiedere fino a 24 ore intere, poiché è stata memorizzata nella cache con la durata più lunga e immutabile.

Stampa

  • Un codice già stampato continua a funzionare, indipendentemente dal fatto che un logo venga aggiunto, sostituito o rimosso – la destinazione codificata non dipende mai dal logo.
  • L’aggiunta o la rimozione di un logo modifica il motivo a punti. Se il logo stesso deve apparire sul materiale di stampa, ristampare con il file qr.svg o qr.png corrente – non mescolare mai i vecchi e i nuovi file di stampa.
  • La sostituzione di un logo non modifica il motivo; una ristampa è quindi solo una questione di ottenere la nuova immagine desiderata, non di scansionabilità.
  • qr.pdf e qr.eps non contengono mai un logo. Per i layout di stampa che devono mostrare il logo, scaricare qr.svg o qr.png.
  • Prima di una tiratura di stampa completa, effettuare sempre una scansione di prova sul materiale reale, specialmente dopo una modifica del motivo.

Correlati