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.

Eventi con biglietti: 1 nel piano FreeBiglietti emessi: 50 nel piano Free

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.

Biglietti firmati

Ogni codice contiene una firma: un codice inventato o alterato viene riconosciuto come non valido.

Pagina del biglietto per il cliente

Evento, luogo, data, posto e QR in una pagina che si apre dal telefono, con lo stato aggiornato (valido, già utilizzato, annullato). Senza cookie.

Convalida dal telefono

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.

Chiavi dedicate alla sola convalida

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.

Nessun doppio ingresso, anche con rete scarsa

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.

Anche buoni a usi, a credito e sconti

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.

Finestre, ingressi multipli e blocchi

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.

VALIDO

Ingresso registrato; per i biglietti multipli quanti ne restano.

GIÀ USATO

Con l'orario e il varco del primo ingresso.

ANNULLATO

Annullato da te, con il motivo.

FUORI ORARIO

Prima o dopo la finestra di validità, con gli orari.

ALTRO EVENTO

Il biglietto vale per un altro evento: compare il nome.

NON TROVATO

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.

Buoni a usi

Omaggi, carnet di ingressi, consumazioni: ogni riscatto consuma un uso.

Campagne di buoni: 1 nel piano Free
Buoni a credito

Buoni regalo in euro: a ogni uso si scala l'importo e la pagina del cliente mostra il saldo.

Buoni emessi: 50 nel piano Free
Buoni sconto

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 è.

Concerti e teatri

Posto, settore e un ingresso per biglietto.

Fiere e congressi

Più giorni, più varchi, chiavi per ogni ingresso.

Musei e visite

Fasce orarie con la finestra di validità.

Palestre e corsi

Carnet di ingressi con i buoni a usi.

Negozi e locali

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.

Webhook ticket.validated e voucher.redeemed

Il tuo server riceve una chiamata firmata a ogni ingresso o riscatto: varco, ingressi rimasti, saldo, sconto.

Dal piano Business
Come funziona →
Statistiche per evento

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.

VoceFreeStandardPremiumBusiness
Biglietti
Eventi con biglietti 110100500
Biglietti emessi 502.00050.000500.000
Chiavi di convalida ai varchi 31050200
Buoni
Campagne di buoni 110100500
Buoni emessi 502.00050.000500.000
Account
Richieste API al mese 20020.000Nessun limite1.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/tickets

Header richiesto

x-api-key: LA_TUA_API_KEY
  • POST/api/v1/tickets/events

    Crea un evento: name, venue, startsAt, endsAt, validFrom, validUntil, maxEntries.

  • GET/api/v1/tickets/events

    Elenco degli eventi con la quota in uso.

  • GET/api/v1/tickets/events/:id

    Dettaglio di un evento.

  • PATCH/api/v1/tickets/events/:id

    Modifica nome, luogo e date (non maxEntries).

  • DELETE/api/v1/tickets/events/:id

    Elimina l'evento.

  • GET/api/v1/tickets/events/:id/summary

    Riepilogo: biglietti emessi, annullati, entrati e scansioni respinte per esito.

  • POST/api/v1/tickets/events/:id/tickets

    Emette uno o più biglietti (fino a 500 per chiamata): category, seat, holderName.

  • GET/api/v1/tickets/events/:id/tickets

    Elenco dei biglietti dell'evento.

  • GET/api/v1/tickets/tickets/:id

    Dettaglio di un biglietto, con il link alla sua pagina.

  • GET/api/v1/tickets/tickets/:id/image

    Immagine del biglietto con il QR (png, jpeg, webp, svg).

  • POST/api/v1/tickets/tickets/:id/cancel

    Annulla un biglietto (reason).

  • POST/api/v1/tickets/validator-keys

    Crea una chiave di sola convalida (label, eventId, expiresAt). La chiave si vede una sola volta.

  • GET/api/v1/tickets/validator-keys

    Elenco delle chiavi (senza il valore).

  • DELETE/api/v1/tickets/validator-keys/:id

    Revoca una chiave.

Buoni a usi e a credito 12 · /api/v1/vouchers

Indirizzo

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

Header richiesto

x-api-key: LA_TUA_API_KEY
  • POST/api/v1/vouchers/campaigns

    Crea una campagna di buoni: name, description, kind (uses o credit), uses oppure credit in centesimi, validFrom, validUntil.

  • GET/api/v1/vouchers/campaigns

    Elenco delle campagne con la quota in uso.

  • GET/api/v1/vouchers/campaigns/:id

    Dettaglio di una campagna.

  • PATCH/api/v1/vouchers/campaigns/:id

    Modifica nome, descrizione e scadenza (tipo e valore non cambiano).

  • DELETE/api/v1/vouchers/campaigns/:id

    Elimina la campagna: i suoi buoni non si riscattano più.

  • GET/api/v1/vouchers/campaigns/:id/summary

    Riepilogo: buoni emessi, annullati, usati, esauriti, riscatti, credito o usi spesi e rimasti.

  • POST/api/v1/vouchers/campaigns/:id/vouchers

    Emette uno o più buoni (fino a 500 per chiamata): holderName, note.

  • GET/api/v1/vouchers/campaigns/:id/vouchers

    Elenco dei buoni della campagna.

  • GET/api/v1/vouchers/vouchers/:id

    Dettaglio di un buono con usi rimasti o saldo e il link alla sua pagina.

  • GET/api/v1/vouchers/vouchers/:id/image

    Immagine del QR del buono (format, size, dark, light).

  • POST/api/v1/vouchers/vouchers/:id/cancel

    Annulla un buono (reason).

  • GET/api/v1/vouchers/vouchers/:id/redemptions

    Registro 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-validation

Header richiesto

x-validator-key: LA_CHIAVE_DI_CONVALIDA
  • POST/api/v1/ticket-validation/scan

    Convalida un biglietto: code, gate (facoltativo), scanId (facoltativo). Risponde 200 per ogni esito.

  • GET/api/v1/ticket-validation/me

    Mostra a quale evento e fino a quando vale la chiave in uso.

  • GET/api/v1/ticket-validation/voucher/:code

    Consulta un buono prima di riscattarlo: residuo, stato e validità, senza scrivere nulla.

  • POST/api/v1/ticket-validation/redeem

    Riscatta 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

CampoTipoObbligatorioDescrizione
nametestoSìNome dell'evento, fino a 120 caratteri.
venuetestoNoLuogo, fino a 120 caratteri.
startsAtdata e ora ISO 8601Sì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.
endsAtdata e ora ISO 8601SìFine dell'evento.
validFromdata e ora ISO 8601NoDal momento in cui i biglietti possono entrare. Se manca vale l'inizio dell'evento.
validUntildata e ora ISO 8601NoFino al momento in cui i biglietti possono entrare. Se manca vale la fine dell'evento. Durata massima della finestra: 400 giorni.
maxEntriesnumero interoNoIngressi consentiti per ogni biglietto, da 1 a 20. Predefinito 1.

Modifica un evento (corpo JSON)
PATCH /api/v1/tickets/events/:id

CampoTipoObbligatorioDescrizione
nametestoNoNuovo nome, fino a 120 caratteri.
venuetestoNoNuovo luogo, fino a 120 caratteri.
startsAtdata e ora ISO 8601NoNuovo inizio.
endsAtdata e ora ISO 8601NoNuova fine.
validFromdata e ora ISO 8601NoNuovo inizio della finestra di ingresso.
validUntildata e ora ISO 8601NoNuova fine della finestra di ingresso.

Emetti biglietti (corpo JSON)
POST /api/v1/tickets/events/:id/tickets

CampoTipoObbligatorioDescrizione
categorytestoNoCategoria (per esempio «Platea»), fino a 40 caratteri.
seattestoNoPosto, fino a 40 caratteri.
holderNametestoNoNome 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

CampoTipoObbligatorioDescrizione
reasontestoNoMotivo dell'annullamento, fino a 120 caratteri.

Crea una chiave di convalida (corpo JSON)
POST /api/v1/tickets/validator-keys

CampoTipoObbligatorioDescrizione
labeltestoSìNome della chiave (per esempio «Varco A»), fino a 60 caratteri. Se il varco non è indicato nella scansione, si usa questo nome.
eventIdtestoNoSe indicato, la chiave convalida solo i biglietti di quell'evento.
expiresAtdata e ora ISO 8601NoScadenza 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

CampoTipoObbligatorioDescrizione
nametestoSìNome della campagna (per esempio «Buono regalo»), fino a 120 caratteri.
descriptiontestoNoCosa dà il buono, mostrato sulla sua pagina, fino a 300 caratteri.
kindtestoSìuses: un numero di usi (omaggio, sconto, carnet); credit: un credito in euro che si scala a ogni uso.
usesnumero interoNoSolo con kind uses, e lì obbligatorio: usi per buono, da 1 a 100.
creditnumero interoNoSolo con kind credit, e lì obbligatorio: credito per buono in centesimi, da 1 a 1.000.000 (5000 = 50,00 €).
currencytestoNoPer ora solo EUR (predefinito).
validFromdata e ora ISO 8601NoDa quando il buono si può usare. Se manca: da subito.
validUntildata e ora ISO 8601NoScadenza. Se manca il buono non scade; al massimo 1.100 giorni dopo l'inizio.
discountoggettoNoSolo 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.
menuIdtestoNoFacoltativo, 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

CampoTipoObbligatorioDescrizione
nametestoNoNuovo nome, fino a 120 caratteri.
descriptiontestoNoNuova descrizione, fino a 300 caratteri.
validUntildata e ora ISO 8601NoNuova scadenza; null la toglie.

Emetti buoni (corpo JSON)
POST /api/v1/vouchers/campaigns/:id/vouchers

CampoTipoObbligatorioDescrizione
holderNametestoNoNome dell'intestatario, fino a 120 caratteri.
notetestoNoNota 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

CampoTipoObbligatorioDescrizione
codetestoSìIl codice del buono: la parte finale dell'indirizzo contenuto nel QR (…/b/CODICE).
amountnumero interoNoSolo 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.
gatetestoNoCassa o varco; oltre 40 caratteri viene accorciato. Se manca si usa il nome della chiave.
scanIdtestoNoIdentificativo 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

CampoTipoObbligatorioDescrizione
codetestoSì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.
gatetestoNoNome del varco; oltre 40 caratteri viene accorciato. Se manca si usa il nome della chiave.
scanIdtestoNoIdentificativo 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à.

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.

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
StatusCodiceQuando accade
403LIMITE_EVENTIHai raggiunto il numero di eventi del tuo piano.
403LIMITE_BIGLIETTIHai raggiunto il numero di biglietti del tuo piano (contano anche gli annullati).
403LIMITE_CHIAVIHai raggiunto il numero di chiavi di convalida del tuo piano.
503ERRORE_TEMPORANEOLa 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.

Prova Biglietti con convalida con la tua chiave.

Dalla dashboard sviluppatori generi la chiave e gestisci tutto anche senza scrivere codice.