Leggi l'intera risposta
Per uno stato non riuscito, conserva il codice HTTP, le intestazioni, il corpo dell'errore e l'ID richiesta dopo aver rimosso i segreti. Questi elementi distinguono una richiesta non valida da un rifiuto di accesso o un problema temporaneo.
Non esporre una risposta grezza del servizio come unico messaggio all'utente: spiega l'azione conservando i dettagli diagnostici per un operatore.
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'Classifica l'errore
- Un errore 4xx richiede di solito la correzione di una chiave, dei dati di input o dell'accesso.
- Un errore 429 richiede di rispettare la finestra del limite ed evitare nuovi tentativi aggressivi.
- Gli errori 5xx e di rete richiedono tentativi limitati con attesa esponenziale e variazione casuale.
Riprova in sicurezza
Riprova solo dopo errori temporanei e soltanto se l'operazione è idempotente nel tuo prodotto. Per la generazione, conserva un ID richiesta del client per evitare un doppio addebito o un artefatto duplicato.
Nello streaming, distingui un errore precedente al primo delta da un'interruzione dopo un output parziale: quest'ultima non può essere sostituita silenziosamente con una nuova risposta.