InfoTarga

Errori

In caso di errore, l'API restituisce un codice HTTP appropriato e un corpo JSON con questa struttura:

Risposta JSON

Campo	Tipo	Descrizione
`success`	`false`	Indica che la richiesta non è stata completata.
`code`	`string`	Codice stabile dell'errore.
`message`	`string`	Descrizione dell'errore.
`data`	`null`	Nessun risultato disponibile.
`timestamp`	`number`	Data e ora della risposta, come timestamp Unix in millisecondi.

Per gestire gli errori nell'integrazione, utilizza lo status HTTP e il valore di code.

Codice	Status	Significato
`bad-request`	400	Corpo JSON non valido, campi obbligatori assenti, servizi non validi o duplicati.
`invalid-plate-format`	400	Formato della targa non valido per la tipologia di veicolo indicata.
`missing-api-key`	401	Header `x-api-key` assente.
`invalid-api-key`	401	Chiave API non valida o non attiva.

Codice	Status	Significato
`no-active-subscription`	403	Nessuna sottoscrizione attiva per il servizio.
`incomplete-subscription`	403	Attivazione della sottoscrizione non completata.
`past-due-subscription`	403	Pagamento della sottoscrizione scaduto.

La sottoscrizione può essere gestita dalla sezione Profilo › Fatturazione.

Codice	Status	Significato
`burst-limit-exceeded`	429	Limite di richieste in un breve intervallo superato.
`daily-limit-exceeded`	429	Limite giornaliero superato.
`monthly-quota-exceeded`	429	Quota mensile superata.

Le risposte con status 429 possono includere:

Header	Descrizione
`CW-Rate-Limited-By`	Limite applicato: `burst`, `daily` oppure `monthly`.
`CW-Rate-Limited-Until`	Timestamp Unix in millisecondi in cui il limite verrà ripristinato.
`Retry-After`	Numero di secondi da attendere prima di ripetere la richiesta.

Codice	Status	Significato
`internal-server-error`	500	Errore interno durante l'elaborazione della richiesta.
`unexpected-error`	500	Errore imprevisto.

L'header CW-Trace-Id, quando presente, identifica la richiesta e può essere comunicato al supporto.

1
expressive-code-css