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.