# Errori e codici di stato

Gestire i fallimenti Foxora API tramite lo stato HTTP, codice di errore strutturato e `x-request-id`, mantenendo le credenziali e il contenuto dei prompt fuori dai log.

| Stato | Significato | Azione del cliente |
| --- | --- | --- |
| `400` | Richiesta non valida | Correggi il payload; non riprovare senza modifiche. |
| `401` | Autenticazione fallita | Aggiorna o sostituisci il token dell'account. |
| `403` | Funzionalità o piano negato | Verifica i diritti e il modello richiesto. |
| `404` | Percorso o risorsa mancante | Controlla il percorso e l'identificatore `/v1`. |
| `429` | Limite di richieste raggiunto | Attendere le istruzioni per il reset e ridurre la concorrenza. |
| `5xx` | Malfunzionamento del servizio | Riprova il lavoro sicuro con backoff limitato e jitter. |

Le rotte sconosciute restituiscono `NOT_FOUND`; i fallimenti di convalida restituiscono `VALIDATION_ERROR`; i fallimenti imprevisti restituiscono `INTERNAL_ERROR`. I messaggi specifici a monte possono variare, quindi non costruire il flusso di controllo basandoti sul testo.

**Risultato previsto:** Il client corregge un errore permanente della richiesta oppure esegue un tentativo limitato mantenendo l'identificatore della richiesta per il supporto.