Errori

Gestione errori

L'API utilizza codici di risposta HTTP convenzionali per indicare il successo o il fallimento delle richieste.

Codici di stato HTTP

Code	Descrizione
`200`	Successo - Richiesta completata con successo
`400`	Richiesta errata - Parametri di richiesta non validi
`401`	Non autorizzato - Chiave API non valida o mancante
`404`	Non trovato - La risorsa richiesta non esiste
`500`	Errore interno del server - Si è verificato un errore del server

Tutte le risposte di errore seguono un formato coerente:

Struttura della risposta di errorejson

{
  "success": false,
  "error": "Human-readable error message",
  "code": "ERROR_CODE"
}

Code	Descrizione
`UNAUTHORIZED`	Chiave API non valida o mancante
`INVALID_PARAMS`	Validazione parametri query fallita
`INVALID_ID`	Formato UUID non valido per ID tariffa
`NOT_FOUND`	La tariffa richiesta non esiste
`DATABASE_ERROR`	Query database fallita
`INTERNAL_ERROR`	Errore server imprevisto

Chiave API mancante o non validajson

{
  "success": false,
  "error": "Unauthorized",
  "code": "UNAUTHORIZED"
}

Parametri di richiesta non validijson

{
  "success": false,
  "error": "Invalid query parameters",
  "code": "INVALID_PARAMS"
}

Risorsa non trovatajson

{
  "success": false,
  "error": "Tariff not found",
  "code": "NOT_FOUND"
}

1.Controlla sempre il campo success nella risposta per determinare se la richiesta è andata a buon fine
2.Usa il campo code per la gestione programmatica degli errori nella tua applicazione
3.Mostra il messaggio error agli utenti per fornire un riscontro comprensibile
4.Implementa un backoff esponenziale per riprovare le richieste non riuscite, soprattutto per gli errori 5xx