API REST per QR dinamici: stampi una volta, cambi la destinazione quando vuoi

Crea QR che puntano a un link corto stabile. Cambia la destinazione, metti in pausa o riattiva e leggi le statistiche di scansione, senza ristampare.

Un QR dinamico contiene un link corto del nostro dominio. Quando qualcuno lo inquadra, lo portiamo alla destinazione che hai impostato. Se la destinazione cambia, il QR stampato resta lo stesso: aggiorni il link con una chiamata API o dalla dashboard.

Scheda tecnica Piani e limiti

API REST per creare QR dinamici modificabili

Perché usarlo QR dinamici: i punti di forza

Il QR stampato non cambia

L'immagine contiene il link corto stabile: cambiare destinazione non cambia il codice, quindi non devi ristampare.

Pausa e riattivazione

Metti in pausa un QR senza eliminarlo e riattivalo quando serve, per esempio per una promozione a tempo.

Statistiche di scansione

Scansioni totali, ultima scansione e andamento per giorno, dispositivo, provenienza e paese (quando disponibile).

Le scansioni non consumano richieste

Le scansioni dei tuoi clienti non contano nella quota di richieste API: contano solo le chiamate che fai tu.

Formati e stile

Immagine in PNG, JPEG, WebP o SVG, dimensione da 100 a 2000 pixel, colori a scelta e logo al centro (sull'SVG il logo non si applica).

Anche senza scrivere codice

Dalla dashboard sviluppatori crei, modifichi, metti in pausa, scarichi e controlli le statistiche, con la stessa chiave e gli stessi limiti.

Come funziona

Crea il QR con una chiamata POST indicando la destinazione: ricevi il link corto e l'immagine.
Stampa o pubblica l'immagine: contiene sempre lo stesso link corto.
Quando serve, cambia la destinazione con PATCH o mettilo in pausa; leggi le statistiche con GET.

Cosa include ogni piano

I limiti sono quelli dei piani in vigore. Un valore «Nessun limite» significa che non c'è un tetto per quella voce.

Voce	Free	Standard	Premium
Richieste API al mese	500	20.000	Nessun limite
QR dinamici modificabili	3	100	1.000

Tutti i prodotti dell'API REST usano la stessa chiave e lo stesso piano. Prezzi e dettagli nella pagina Piani e prezzi.

Scheda tecnica: QR dinamici

Tutte le richieste partono da https://www.qrcodegenerate.it. Le risposte sono in JSON e gli errori hanno sempre la forma { "status", "code", "message" }. La chiave va conservata lato server: non inserirla in codice pubblico o in un frontend non protetto.

QR dinamici

https://www.qrcodegenerate.it/api/v1/qrcode/dynamic

Header richiesto

x-api-key: LA_TUA_API_KEY

Metodo	Percorso	Descrizione
`POST`	`/api/v1/qrcode/dynamic`	Crea un QR dinamico: destinationUrl (obbligatorio), label, format, size, color, logoUrl. Risposta 201 con id, shortUrl e immagine.
`GET`	`/api/v1/qrcode/dynamic`	Elenco dei tuoi QR (limit fino a 100, offset) con la quota in uso.
`GET`	`/api/v1/qrcode/dynamic/:id`	Dettaglio di un QR: stato, destinazione, scansioni totali, ultima scansione.
`GET`	`/api/v1/qrcode/dynamic/:id/image`	Immagine del QR (format, size, dark, light).
`GET`	`/api/v1/qrcode/dynamic/:id/stats`	Statistiche per intervallo (from, to): per giorno, dispositivo, provenienza e paese.
`PATCH`	`/api/v1/qrcode/dynamic/:id`	Cambia destinationUrl, label o status (active oppure paused).
`DELETE`	`/api/v1/qrcode/dynamic/:id`	Elimina il QR (eliminazione logica).

Errori frequenti

Status	Codice	Quando accade
`403`	`LIMITE_QR_DINAMICI`	Hai raggiunto il numero di QR dinamici del tuo piano.
`422`	`CAMPO_NON_CONSENTITO`	Hai inviato un campo che non si può impostare (per esempio il codice).
`404`	`ROTTA_NON_TROVATA`	Percorso inesistente o identificativo non valido: la risposta è sempre JSON.

Ogni risposta di errore ha la forma { status, code, message }.

I QR e le statistiche sono sempre privati: vedi solo quelli del tuo account.

Esempi

Crea un QR dinamico

curl -X POST "https://www.qrcodegenerate.it/api/v1/qrcode/dynamic" \
  -H "Content-Type: application/json" \
  -H "x-api-key: LA_TUA_API_KEY" \
  -d '{
    "destinationUrl": "https://www.esempio.it/menu",
    "label": "Tavolo 12",
    "format": "png",
    "size": 600
  }'

Cambia la destinazione senza ristampare

curl -X PATCH "https://www.qrcodegenerate.it/api/v1/qrcode/dynamic/ID_DEL_QR" \
  -H "Content-Type: application/json" \
  -H "x-api-key: LA_TUA_API_KEY" \
  -d '{ "destinationUrl": "https://www.esempio.it/menu-autunno" }'

Gli esempi per i linguaggi più comuni sul generatore di QR statici sono nella documentazione generale.

Domande frequenti: QR dinamici

Cosa cambia rispetto a un QR statico?

Il QR statico contiene direttamente il contenuto e non si può modificare. Il QR dinamico contiene un link corto: puoi cambiare la destinazione senza ristampare e vedere le scansioni.

Le scansioni dei clienti consumano la mia quota di richieste?

No. La quota di richieste conta solo le chiamate API che fai tu.

Posso mettere il logo?

Sì, con il parametro logoUrl sui formati PNG, JPEG e WebP. Se il logo non può essere usato, il QR esce senza logo e la risposta lo segnala.

Altri prodotti dell'API REST

Biglietti con convalida

Emetti biglietti con QR firmato e convalidali ai varchi dal telefono, con chiavi dedicate e senza doppi ingressi.

Etichette digitali

Una pagina pubblica neutra per ogni prodotto, raggiungibile da un QR sull'etichetta. Modello pronto per il vino e modelli tuoi, con versioni.

Prova QR dinamici con la tua chiave API

Dalla dashboard sviluppatori generi la chiave e gestisci anche senza scrivere codice. Vedi i piani per limiti e prezzi.

Apri la dashboard