API REST per etichette digitali: una pagina neutra raggiungibile da un QR

Pubblica ingredienti, allergeni, valori nutrizionali e altre informazioni di prodotto in una pagina pubblica, in italiano e inglese, collegata a un QR sull'etichetta.

Per ogni prodotto crei una scheda a partire da un modello. La scheda ha una pagina pubblica con un indirizzo che non cambia quando aggiorni i dati: ci stampi il QR sull'etichetta. La pagina è neutra, cioè mostra solo le informazioni di prodotto.

Scheda tecnica Piani e limiti

API REST per etichette digitali di prodotto

Perché usarlo Etichette digitali: i punti di forza

Pagina neutra per costruzione

Nessun cookie, nessuno script, nessun link e nessuna pubblicità: la pagina mostra solo le informazioni del prodotto e non registra le letture.

Modello pronto per il vino

Produttore, annata, titolo alcolometrico, volume, lotto, ingredienti, allergeni e dichiarazione nutrizionale per 100 ml.

Modelli tuoi per qualsiasi prodotto

Definisci sezioni (dettagli, elenco, tabella) e campi di testo, testo lungo, elenco e numero, con lingue, campi obbligatori e traducibili. Anche dalla dashboard, con anteprima.

Le modifiche non rompono le schede esistenti

Ogni modifica a un modello crea una nuova versione: le schede già pubblicate restano come sono finché non le porti alla nuova versione.

Italiano e inglese

I campi traducibili hanno un valore per lingua. Se una traduzione manca, la pagina mostra la lingua base, indicata come tale.

Modifiche sicure

Con il numero di revisione, se due persone modificano la stessa scheda la seconda riceve un conflitto invece di sovrascrivere il lavoro della prima.

Come funziona

Scegli un modello: quello per il vino oppure uno che hai creato tu.
Crea la scheda con i dati del prodotto e le lingue: ricevi il link pubblico e l'immagine del QR.
Stampa il QR sull'etichetta. Aggiorna i dati quando vuoi: l'indirizzo resta lo stesso.

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
Etichette digitali	3	50	500
Modelli di etichetta propri	2	10	50

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

Scheda tecnica: Etichette digitali

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.

Modelli

https://www.qrcodegenerate.it/api/v1/labels

Header richiesto

x-api-key: LA_TUA_API_KEY

Metodo	Percorso	Descrizione
`GET`	`/api/v1/labels/templates`	Modelli disponibili (predefiniti e tuoi) con campi, tipi, limiti ed etichette per lingua, più la quota dei tuoi modelli.
`POST`	`/api/v1/labels/templates`	Crea un tuo modello: title, languages, sections. I modelli propri sono sempre neutri.
`GET`	`/api/v1/labels/templates/:id`	Dettaglio di un modello (version per le versioni precedenti dei tuoi).
`PUT`	`/api/v1/labels/templates/:id`	Salva una nuova versione del tuo modello. Le schede esistenti non cambiano.
`DELETE`	`/api/v1/labels/templates/:id`	Archivia il tuo modello: le schede già create continuano a vedersi.

Schede prodotto

https://www.qrcodegenerate.it/api/v1/labels

Header richiesto

x-api-key: LA_TUA_API_KEY

Metodo	Percorso	Descrizione
`POST`	`/api/v1/labels/products`	Crea una scheda: templateId, name, languages, data.
`GET`	`/api/v1/labels/products`	Elenco delle schede (limit, offset) con la quota in uso.
`GET`	`/api/v1/labels/products/:id`	Dettaglio di una scheda, con il link pubblico.
`PATCH`	`/api/v1/labels/products/:id`	Modifica name, languages, data (null cancella un campo), revision e templateVersion.
`DELETE`	`/api/v1/labels/products/:id`	Elimina la scheda: la pagina pubblica risponde «non più disponibile».
`GET`	`/api/v1/labels/products/:id/image`	Immagine del QR del link pubblico (format, size, dark, light).

Errori frequenti

Status	Codice	Quando accade
`403`	`LIMITE_SCHEDE`	Hai raggiunto il numero di schede del tuo piano.
`403`	`LIMITE_MODELLI`	Hai raggiunto il numero di modelli propri del tuo piano.
`422`	`MODELLO_NON_VALIDO`	La definizione del modello non è valida.
`422`	`CONTENUTO_NON_NEUTRO`	Un testo contiene un indirizzo web (http, https o www): le pagine neutre non ammettono link.
`409`	`MODIFICA_CONCORRENTE`	La scheda o il modello sono cambiati mentre li modificavi: rileggi e riprova.

La pagina digitale integra l'etichetta fisica, non la sostituisce: le indicazioni obbligatorie per legge restano a carico di chi pubblica il prodotto. Verifica con il tuo consulente cosa deve comparire sull'etichetta stampata.

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

Esempi

Crea la scheda di un vino

curl -X POST "https://www.qrcodegenerate.it/api/v1/labels/products" \
  -H "Content-Type: application/json" \
  -H "x-api-key: LA_TUA_API_KEY" \
  -d '{
    "templateId": "vino",
    "name": "Rosso Esempio 2024",
    "languages": ["it", "en"],
    "data": {
      "produttore": "Cantina Esempio",
      "annata": "2024",
      "gradazione": 13.5,
      "denominazione": { "it": "Vino rosso", "en": "Red wine" },
      "ingredienti": { "it": ["Uve"], "en": ["Grapes"] }
    }
  }'

Aggiorna un dato senza cambiare il link

curl -X PATCH "https://www.qrcodegenerate.it/api/v1/labels/products/ID_SCHEDA" \
  -H "Content-Type: application/json" \
  -H "x-api-key: LA_TUA_API_KEY" \
  -d '{ "data": { "lotto": "L2401" }, "revision": 1 }'

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

Domande frequenti: Etichette digitali

La pagina dell'etichetta contiene pubblicità o tracciamento?

No. La pagina è neutra: nessun cookie, nessuno script, nessun link e nessuna statistica delle letture.

Se cambio un modello cosa succede alle schede già pubblicate?

Niente: ogni modifica crea una nuova versione e le schede restano sulla versione con cui sono nate, finché non le porti tu alla nuova.

Posso usarlo per prodotti diversi dal vino?

Sì. Crei un tuo modello con le sezioni e i campi che servono (testo, elenco, numero) e lo usi per tutti i prodotti che vuoi.

Altri prodotti dell'API REST

QR dinamici

Stampi il QR una volta e cambi la destinazione quando vuoi. Pausa, riattivazione e statistiche di scansione, senza ristampare.

Biglietti con convalida

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

Prova Etichette digitali 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