API REST · Biglietti con convalida
Biglietti con QR firmato, convalidati dal telefono
Emetti biglietti con QR firmato per eventi e ingressi. Il personale li convalida dal telefono con una chiave dedicata, con esito chiaro a colori.
Teatro Comunale · 20 nov, 21:00
Platea · A12
ValidoIngressi rimasti: 1 di 2
Perché usarlo.
Crei un evento, emetti i biglietti (anche a blocchi) e ottieni per ognuno un codice firmato, una pagina da mostrare al cliente e un'immagine QR. Ai varchi il personale usa una pagina di convalida con una chiave che può solo convalidare.
Ogni codice contiene una firma: un codice inventato o alterato viene riconosciuto come non valido.
Evento, luogo, data, posto e QR in una pagina che si apre dal telefono, con lo stato aggiornato (valido, già utilizzato, annullato). Senza cookie.
Pagina di convalida per il personale con fotocamera (dove il browser la supporta) o inserimento manuale del codice, anche con lettori USB e Bluetooth. L'esito è a colori e a parole.
Ai varchi dai una chiave che può solo convalidare: si revoca in qualsiasi momento, scade da sola e può valere per un solo evento. La chiave API completa non vale per la convalida e viceversa.
Con scanId, se il telefono ripete la richiesta dopo un timeout non viene consumato un secondo ingresso. In caso di dubbio il sistema non risponde mai «valido» senza aver registrato l'ingresso.
Omaggi, carnet di ingressi, buoni regalo in euro e buoni sconto in % o in euro, con pagina e QR per il cliente. Si riscattano con la stessa chiave dei varchi: il saldo si scala a ogni uso e non scende sotto zero.
Finestra di validità separata dall'orario dell'evento, da 1 a 20 ingressi per biglietto, fino a 500 biglietti per chiamata, annullamento con motivo.
Ai varchi: un esito chiaro, sempre.
Il personale vede il risultato a colori e a parole, mai solo il colore. Le stesse parole tornano nell'API, nel campo result.
Ingresso registrato; per i biglietti multipli quanti ne restano.
Con l'orario e il varco del primo ingresso.
Annullato da te, con il motivo.
Prima o dopo la finestra di validità, con gli orari.
Il biglietto vale per un altro evento: compare il nome.
Codice inventato, alterato o di un altro account.
Anche buoni a usi, a credito e sconti.
Con la stessa chiave dei varchi si riscattano anche i buoni: il saldo si scala a ogni uso e non scende sotto zero.
Omaggi, carnet di ingressi, consumazioni: ogni riscatto consuma un uso.
Buoni regalo in euro: a ogni uso si scala l'importo e la pagina del cliente mostra il saldo.
In percentuale o in euro, monouso o per più usi. Alla cassa il personale vede quanto applicare, il tuo gestionale lo riceve nella risposta.
Per chi è.
Posto, settore e un ingresso per biglietto.
Più giorni, più varchi, chiavi per ogni ingresso.
Fasce orarie con la finestra di validità.
Carnet di ingressi con i buoni a usi.
Buoni regalo, sconti e omaggi.
Come funziona.
Crea l'evento con nome, luogo, date e finestra di validità.
Emetti i biglietti: uno o un blocco. Ognuno ha codice, pagina pubblica e immagine QR.
Crea una chiave di convalida per i varchi (si vede una volta sola) e consegnala al personale.
Ai varchi il personale scansiona: esito valido, già usato, annullato, fuori orario, altro evento o non trovato.
Ogni operazione nel tuo gestionale.
Il tuo server riceve una chiamata firmata a ogni ingresso o riscatto: varco, ingressi rimasti, saldo, sconto.
Ingressi, rifiuti per tipo ed esito per varco nella dashboard, senza scrivere codice.
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. Sul telefono la tabella scorre di lato.
| Voce | Free | Standard | Premium | Business |
|---|---|---|---|---|
| Biglietti | ||||
| Eventi con biglietti | 1 | 10 | 100 | 500 |
| Biglietti emessi | 50 | 2.000 | 50.000 | 500.000 |
| Chiavi di convalida ai varchi | 3 | 10 | 50 | 200 |
| Buoni | ||||
| Campagne di buoni | 1 | 10 | 100 | 500 |
| Buoni emessi | 50 | 2.000 | 50.000 | 500.000 |
| Account | ||||
| Richieste API al mese | 200 | 20.000 | Nessun limite | 1.000.000 |
| Webhook | — | — | — | 5 |
Tutti i prodotti dell'API REST usano la stessa chiave e lo stesso piano. Prezzi e dettagli nella pagina Piani e prezzi.
Scheda tecnica.
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.
Gestione di eventi, biglietti e chiavi 14 · /api/v1/tickets
Indirizzo
https://www.qrcodegenerate.it/api/v1/ticketsHeader richiesto
x-api-key: LA_TUA_API_KEY- POST
/api/v1/tickets/eventsCrea un evento: name, venue, startsAt, endsAt, validFrom, validUntil, maxEntries.
- GET
/api/v1/tickets/eventsElenco degli eventi con la quota in uso.
- GET
/api/v1/tickets/events/:idDettaglio di un evento.
- PATCH
/api/v1/tickets/events/:idModifica nome, luogo e date (non maxEntries).
- DELETE
/api/v1/tickets/events/:idElimina l'evento.
- GET
/api/v1/tickets/events/:id/summaryRiepilogo: biglietti emessi, annullati, entrati e scansioni respinte per esito.
- POST
/api/v1/tickets/events/:id/ticketsEmette uno o più biglietti (fino a 500 per chiamata): category, seat, holderName.
- GET
/api/v1/tickets/events/:id/ticketsElenco dei biglietti dell'evento.
- GET
/api/v1/tickets/tickets/:idDettaglio di un biglietto, con il link alla sua pagina.
- GET
/api/v1/tickets/tickets/:id/imageImmagine del biglietto con il QR (png, jpeg, webp, svg).
- POST
/api/v1/tickets/tickets/:id/cancelAnnulla un biglietto (reason).
- POST
/api/v1/tickets/validator-keysCrea una chiave di sola convalida (label, eventId, expiresAt). La chiave si vede una sola volta.
- GET
/api/v1/tickets/validator-keysElenco delle chiavi (senza il valore).
- DELETE
/api/v1/tickets/validator-keys/:idRevoca una chiave.
Buoni a usi e a credito 12 · /api/v1/vouchers
Indirizzo
https://www.qrcodegenerate.it/api/v1/vouchersHeader richiesto
x-api-key: LA_TUA_API_KEY- POST
/api/v1/vouchers/campaignsCrea una campagna di buoni: name, description, kind (uses o credit), uses oppure credit in centesimi, validFrom, validUntil.
- GET
/api/v1/vouchers/campaignsElenco delle campagne con la quota in uso.
- GET
/api/v1/vouchers/campaigns/:idDettaglio di una campagna.
- PATCH
/api/v1/vouchers/campaigns/:idModifica nome, descrizione e scadenza (tipo e valore non cambiano).
- DELETE
/api/v1/vouchers/campaigns/:idElimina la campagna: i suoi buoni non si riscattano più.
- GET
/api/v1/vouchers/campaigns/:id/summaryRiepilogo: buoni emessi, annullati, usati, esauriti, riscatti, credito o usi spesi e rimasti.
- POST
/api/v1/vouchers/campaigns/:id/vouchersEmette uno o più buoni (fino a 500 per chiamata): holderName, note.
- GET
/api/v1/vouchers/campaigns/:id/vouchersElenco dei buoni della campagna.
- GET
/api/v1/vouchers/vouchers/:idDettaglio di un buono con usi rimasti o saldo e il link alla sua pagina.
- GET
/api/v1/vouchers/vouchers/:id/imageImmagine del QR del buono (format, size, dark, light).
- POST
/api/v1/vouchers/vouchers/:id/cancelAnnulla un buono (reason).
- GET
/api/v1/vouchers/vouchers/:id/redemptionsRegistro dei riscatti del buono: data, importo, residuo prima e dopo, varco.
Convalida ai varchi 4 · /api/v1/ticket-validation
Indirizzo
https://www.qrcodegenerate.it/api/v1/ticket-validationHeader richiesto
x-validator-key: LA_CHIAVE_DI_CONVALIDA- POST
/api/v1/ticket-validation/scanConvalida un biglietto: code, gate (facoltativo), scanId (facoltativo). Risponde 200 per ogni esito.
- GET
/api/v1/ticket-validation/meMostra a quale evento e fino a quando vale la chiave in uso.
- GET
/api/v1/ticket-validation/voucher/:codeConsulta un buono prima di riscattarlo: residuo, stato e validità, senza scrivere nulla.
- POST
/api/v1/ticket-validation/redeemRiscatta un buono: code, amount (centesimi, solo per i buoni a credito), gate e scanId facoltativi. Risponde 200 per ogni esito.
Parametri 10 richieste
Per ogni richiesta con un corpo o con parametri nell'indirizzo ecco i campi ammessi. «Obbligatorio» vuol dire che senza quel campo la richiesta viene rifiutata; un campo che non è in tabella viene rifiutato con CAMPO_NON_CONSENTITO.
Crea un evento (corpo JSON)POST /api/v1/tickets/events
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name | testo | Sì | Nome dell'evento, fino a 120 caratteri. |
venue | testo | No | Luogo, fino a 120 caratteri. |
startsAt | data e ora ISO 8601 | Sì | Inizio dell'evento, con il fuso orario (per esempio 2026-10-04T21:00:00+02:00). La durata massima fra inizio e fine è di 400 giorni. |
endsAt | data e ora ISO 8601 | Sì | Fine dell'evento. |
validFrom | data e ora ISO 8601 | No | Dal momento in cui i biglietti possono entrare. Se manca vale l'inizio dell'evento. |
validUntil | data e ora ISO 8601 | No | Fino al momento in cui i biglietti possono entrare. Se manca vale la fine dell'evento. Durata massima della finestra: 400 giorni. |
maxEntries | numero intero | No | Ingressi consentiti per ogni biglietto, da 1 a 20. Predefinito 1. |
Modifica un evento (corpo JSON)PATCH /api/v1/tickets/events/:id
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name | testo | No | Nuovo nome, fino a 120 caratteri. |
venue | testo | No | Nuovo luogo, fino a 120 caratteri. |
startsAt | data e ora ISO 8601 | No | Nuovo inizio. |
endsAt | data e ora ISO 8601 | No | Nuova fine. |
validFrom | data e ora ISO 8601 | No | Nuovo inizio della finestra di ingresso. |
validUntil | data e ora ISO 8601 | No | Nuova fine della finestra di ingresso. |
Emetti biglietti (corpo JSON)POST /api/v1/tickets/events/:id/tickets
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
category | testo | No | Categoria (per esempio «Platea»), fino a 40 caratteri. |
seat | testo | No | Posto, fino a 40 caratteri. |
holderName | testo | No | Nome dell'intestatario, fino a 120 caratteri. |
Per emettere un solo biglietto invia questi campi direttamente. Per emetterne di più invia { "tickets": [ … ] } con da 1 a 500 elementi, ciascuno con gli stessi campi: in questo caso non si possono aggiungere altri campi accanto a tickets.
Annulla un biglietto (corpo JSON, facoltativo)POST /api/v1/tickets/tickets/:id/cancel
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
reason | testo | No | Motivo dell'annullamento, fino a 120 caratteri. |
Crea una chiave di convalida (corpo JSON)POST /api/v1/tickets/validator-keys
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
label | testo | Sì | Nome della chiave (per esempio «Varco A»), fino a 60 caratteri. Se il varco non è indicato nella scansione, si usa questo nome. |
eventId | testo | No | Se indicato, la chiave convalida solo i biglietti di quell'evento. |
expiresAt | data e ora ISO 8601 | No | Scadenza della chiave. Se manca: 24 ore dopo la fine della finestra di ingresso dell'evento, oppure 30 giorni da adesso se la chiave non è legata a un evento. Durata massima: 400 giorni. |
La chiave completa compare solo nella risposta alla creazione: conservala subito.
Crea una campagna di buoni (corpo JSON)POST /api/v1/vouchers/campaigns
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name | testo | Sì | Nome della campagna (per esempio «Buono regalo»), fino a 120 caratteri. |
description | testo | No | Cosa dà il buono, mostrato sulla sua pagina, fino a 300 caratteri. |
kind | testo | Sì | uses: un numero di usi (omaggio, sconto, carnet); credit: un credito in euro che si scala a ogni uso. |
uses | numero intero | No | Solo con kind uses, e lì obbligatorio: usi per buono, da 1 a 100. |
credit | numero intero | No | Solo con kind credit, e lì obbligatorio: credito per buono in centesimi, da 1 a 1.000.000 (5000 = 50,00 €). |
currency | testo | No | Per ora solo EUR (predefinito). |
validFrom | data e ora ISO 8601 | No | Da quando il buono si può usare. Se manca: da subito. |
validUntil | data e ora ISO 8601 | No | Scadenza. Se manca il buono non scade; al massimo 1.100 giorni dopo l'inizio. |
discount | oggetto | No | Solo con kind uses: il buono diventa un buono sconto, in qualsiasi cassa o e-commerce. { "type": "percent", "value": 10 } = 10% di sconto; { "type": "fixed", "value": 500 } = 5 € di sconto (in centesimi). Lo sconto torna nella risposta di riscatto e di consultazione (campaign.discount) e si vede nella pagina del buono; nel carrello del menu digitale si applica da solo. |
menuId | testo | No | Facoltativo, con discount: id del menu digitale in cui vale lo sconto. Se manca vale in tutti i tuoi menu. |
Tipo e valore non si cambiano dopo la creazione: i buoni emessi hanno già il loro valore. Con PATCH /campaigns/:id si cambiano name, description e validUntil (null toglie la scadenza).
Modifica una campagna (corpo JSON, almeno un campo)PATCH /api/v1/vouchers/campaigns/:id
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name | testo | No | Nuovo nome, fino a 120 caratteri. |
description | testo | No | Nuova descrizione, fino a 300 caratteri. |
validUntil | data e ora ISO 8601 | No | Nuova scadenza; null la toglie. |
Emetti buoni (corpo JSON)POST /api/v1/vouchers/campaigns/:id/vouchers
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
holderName | testo | No | Nome dell'intestatario, fino a 120 caratteri. |
note | testo | No | Nota interna, fino a 120 caratteri (non compare sulla pagina del buono). |
Per un buono invia questi campi direttamente; per più buoni invia { "vouchers": [ … ] } con da 1 a 500 elementi.
Riscatta un buono (corpo JSON)POST /api/v1/ticket-validation/redeem
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
code | testo | Sì | Il codice del buono: la parte finale dell'indirizzo contenuto nel QR (…/b/CODICE). |
amount | numero intero | No | Solo per i buoni a credito, e lì obbligatorio: importo da scalare in centesimi. Per i buoni a usi non si indica: ogni riscatto consuma un uso. |
gate | testo | No | Cassa o varco; oltre 40 caratteri viene accorciato. Se manca si usa il nome della chiave. |
scanId | testo | No | Identificativo dell'operazione, da 8 a 64 caratteri: se la stessa richiesta viene ripetuta (per esempio dopo un errore di rete) non si scala due volte e la risposta ha replayed: true. |
Si usa la chiave «solo convalida» nell'header x-validator-key, purché non sia legata a un evento (altrimenti l'esito è wrong_scope). Esiti: redeemed, exhausted, insufficient_balance (nulla scalato), cancelled, outside_window, wrong_scope, not_found; sono tutti risposte 200.
Convalida un biglietto (corpo JSON)POST /api/v1/ticket-validation/scan
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
code | testo | Sì | Il codice del biglietto: è la parte finale dell'indirizzo contenuto nel QR (…/t/CODICE). Spazi e trattini vengono ignorati e le maiuscole non contano. Non passare l'indirizzo intero. |
gate | testo | No | Nome del varco; oltre 40 caratteri viene accorciato. Se manca si usa il nome della chiave. |
scanId | testo | No | Identificativo che scegli tu per questa scansione, da 8 a 64 caratteri (lettere, numeri, trattini). Se ripeti la stessa richiesta con lo stesso scanId, l'ingresso non viene contato due volte e la risposta ha replayed: true. |
Risposte d'esempio 8
Gli esempi qui sotto sono risposte reali dell'API, con valori di fantasia. Le risposte di successo hanno "status": "success" e i dati in data.
Risposta alla creazione di un evento
{
"status": "success",
"message": "Evento creato.",
"data": {
"id": "5d3a9e60-7b1c-4f2e-8c94-1a6b0d2f7e35",
"name": "Concerto di autunno",
"venue": "Teatro Comunale",
"startsAt": "2026-10-04T19:00:00.000Z",
"endsAt": "2026-10-04T22:00:00.000Z",
"validFrom": "2026-10-04T07:00:00.000Z",
"validUntil": "2026-10-04T23:00:00.000Z",
"maxEntries": 1,
"createdAt": "2026-10-04T10:00:00.000Z",
"updatedAt": "2026-10-04T10:00:00.000Z"
}
}
Le date sono sempre in UTC (la Z finale): 21:00 a Roma d'estate diventano 19:00Z.
Risposta all'emissione dei biglietti
{
"status": "success",
"message": "2 biglietti emessi.",
"data": {
"items": [
{
"id": "c41e8a07-93d2-4b6f-a0e5-72f19b3c6d80",
"eventId": "5d3a9e60-7b1c-4f2e-8c94-1a6b0d2f7e35",
"code": "xug89gkdaw583kjb5pxd",
"ticketUrl": "https://www.qrcodegenerate.it/t/xug89gkdaw583kjb5pxd",
"category": "Platea",
"seat": "A12",
"holderName": "Maria Rossi",
"status": "valid",
"entriesUsed": 0,
"maxEntries": 1,
"firstUsedAt": null,
"firstGate": null,
"lastUsedAt": null,
"lastGate": null,
"cancelledAt": null,
"cancelReason": "",
"createdAt": "2026-10-04T10:00:00.000Z"
}
],
"count": 2
}
}
L'esempio mostra un solo biglietto dell'elenco items per brevità.
Riepilogo di un evento
{
"status": "success",
"data": {
"eventId": "5d3a9e60-7b1c-4f2e-8c94-1a6b0d2f7e35",
"issued": 2,
"cancelled": 0,
"entered": 0,
"rejected": {
"already_used": 0,
"cancelled": 0,
"outside_window": 0,
"wrong_event": 0,
"not_found": 0
}
}
}
Risposta alla creazione di una chiave di convalida
{
"status": "success",
"message": "Chiave creata. Copiala ora: non verrà più mostrata.",
"data": {
"id": "e90b27d4-1c58-4a3f-b6d1-48a5f7c20e93",
"label": "Varco A",
"eventId": "5d3a9e60-7b1c-4f2e-8c94-1a6b0d2f7e35",
"keyHint": "tvk_9fe4…7f26",
"status": "active",
"createdAt": "2026-10-04T10:00:00.000Z",
"expiresAt": "2026-10-05T23:00:00.000Z",
"lastUsedAt": null,
"revokedAt": null,
"key": "tvk_LA_CHIAVE_COMPLETA"
}
}
Convalida: biglietto valido
{
"status": "success",
"data": {
"result": "valid",
"message": "Biglietto valido: ingresso registrato.",
"ticket": {
"id": "c41e8a07-93d2-4b6f-a0e5-72f19b3c6d80",
"category": "Platea",
"seat": "A12",
"holderName": "Maria Rossi",
"status": "valid",
"entriesUsed": 1,
"maxEntries": 1,
"firstUsedAt": "2026-10-04T10:00:00.000Z",
"firstGate": "Ingresso A"
},
"event": {
"id": "5d3a9e60-7b1c-4f2e-8c94-1a6b0d2f7e35",
"name": "Concerto di autunno",
"venue": "Teatro Comunale"
},
"entriesLeft": 0
}
}
Gli altri esiti (already_used, cancelled, outside_window, wrong_event, not_found) hanno la stessa forma, con un messaggio diverso e senza entriesLeft. Per not_found, ticket ed event sono null.
Riscatto di un buono a credito
{
"status": "success",
"data": {
"result": "redeemed",
"message": "Buono riscattato.",
"voucher": {
"id": "8b1f2c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d",
"kind": "credit",
"currency": "EUR",
"holderName": "Maria Rossi",
"status": "valid",
"creditInitial": 5000,
"balance": 3750,
"redemptions": 1,
"lastRedeemedAt": "2026-10-04T10:00:00.000Z"
},
"campaign": {
"id": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c6d",
"name": "Buono regalo"
},
"amount": 1250
}
}
Importi in centesimi: 1250 = 12,50 €. Per un buono a usi, voucher contiene usesTotal e usesLeft al posto di creditInitial e balance, e amount è null.
Riepilogo di una campagna di buoni
{
"status": "success",
"data": {
"campaignId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c6d",
"kind": "credit",
"issued": 1,
"cancelled": 0,
"used": 1,
"exhausted": 0,
"redemptions": 1,
"creditIssued": 5000,
"creditSpent": 1250,
"creditLeft": 3750
}
}
Per i buoni a usi al posto dei campi credit… ci sono usesIssued, usesSpent e usesLeft.
Convalida: biglietto già usato
{
"status": "success",
"data": {
"result": "already_used",
"message": "Biglietto già usato.",
"ticket": {
"id": "c41e8a07-93d2-4b6f-a0e5-72f19b3c6d80",
"category": "Platea",
"seat": "A12",
"holderName": "Maria Rossi",
"status": "valid",
"entriesUsed": 1,
"maxEntries": 1,
"firstUsedAt": "2026-10-04T10:00:00.000Z",
"firstGate": "Ingresso A"
},
"event": {
"id": "5d3a9e60-7b1c-4f2e-8c94-1a6b0d2f7e35",
"name": "Concerto di autunno",
"venue": "Teatro Comunale"
}
}
}
Un biglietto già usato, annullato o non trovato è una risposta 200 con il risultato nel campo result: non è un errore HTTP. Un errore HTTP vuol dire che la richiesta o la chiave non sono valide.
Paginazione, limiti di frequenza, webhook, formato delle date ed errori sono spiegati nella guida comune.
Errori frequenti 4
| Status | Codice | Quando accade |
|---|---|---|
403 | LIMITE_EVENTI | Hai raggiunto il numero di eventi del tuo piano. |
403 | LIMITE_BIGLIETTI | Hai raggiunto il numero di biglietti del tuo piano (contano anche gli annullati). |
403 | LIMITE_CHIAVI | Hai raggiunto il numero di chiavi di convalida del tuo piano. |
503 | ERRORE_TEMPORANEO | La convalida non è riuscita a verificare il biglietto: riprova con lo stesso scanId. Non viene mai restituito «valido» senza aver registrato l'ingresso. |
Esiti della convalida (campo result): valid, already_used, cancelled, outside_window, wrong_event, not_found.
La convalida ha limiti propri, più ampi di quelli della gestione, pensati per un varco con molti passaggi.
Ogni risposta di errore ha la forma { status, code, message }.
Esempi 3
Crea un evento
curl -X POST "https://www.qrcodegenerate.it/api/v1/tickets/events" \
-H "Content-Type: application/json" \
-H "x-api-key: LA_TUA_API_KEY" \
-d '{
"name": "Concerto di autunno",
"venue": "Teatro Comunale",
"startsAt": "2026-11-20T21:00:00+01:00",
"endsAt": "2026-11-21T00:00:00+01:00",
"validFrom": "2026-11-20T19:00:00+01:00",
"validUntil": "2026-11-21T01:00:00+01:00"
}'
Emetti un blocco di biglietti
curl -X POST "https://www.qrcodegenerate.it/api/v1/tickets/events/ID_EVENTO/tickets" \
-H "Content-Type: application/json" \
-H "x-api-key: LA_TUA_API_KEY" \
-d '{ "tickets": [
{ "category": "Platea", "seat": "A12", "holderName": "Maria Rossi" },
{ "category": "Platea", "seat": "A13", "holderName": "Luca Bianchi" }
] }'
Convalida ai varchi
curl -X POST "https://www.qrcodegenerate.it/api/v1/ticket-validation/scan" \
-H "Content-Type: application/json" \
-H "x-validator-key: LA_CHIAVE_DI_CONVALIDA" \
-d '{ "code": "CODICE_DEL_BIGLIETTO", "gate": "Ingresso A", "scanId": "ID-UNICO-DELLA-SCANSIONE" }'
Gli esempi per i linguaggi più comuni sul generatore di QR statici sono nella documentazione generale.
Domande frequenti.
Come convalido i biglietti ai varchi?
Crei una chiave di sola convalida e la dai al personale: apre la pagina di convalida dal telefono e scansiona con la fotocamera o scrive il codice. Puoi anche collegare il tuo sistema all'endpoint di scansione.
Cosa succede se un biglietto viene presentato due volte?
La seconda volta l'esito è «già usato» (con più ingressi, finché ne restano). Se il telefono ripete la stessa scansione per un problema di rete, con scanId non si consuma un secondo ingresso.
La chiave dei varchi può fare altro?
No. Può solo convalidare, anche per un solo evento, si può revocare e scade da sola. La tua chiave API completa non va mai consegnata al personale.
Altri servizi dell'API REST.
Stampi il QR una volta e cambi la destinazione quando vuoi. Pausa, riattivazione e statistiche di scansione, senza ristampare.
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.
Anti-contraffazione →Un QR unico e firmato per ogni pezzo venduto: chi lo inquadra vede se il codice è del produttore e quante volte è già stato controllato, e può registrarlo con un PIN nascosto.
Prova Biglietti con convalida con la tua chiave.
Dalla dashboard sviluppatori generi la chiave e gestisci tutto anche senza scrivere codice.