Les hele svaret
Ved en mislykket status beholder du HTTP-koden, hodene, feilobjektet og forespørsels-ID-en etter at hemmeligheter er fjernet. De skiller en ugyldig forespørsel fra avvist tilgang eller et midlertidig problem.
Ikke vis et rått tjenestesvar som den eneste brukermeldingen: forklar handlingen og behold samtidig diagnostiske detaljer for en operatør.
Undersøk et mislykket svar
bash
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":[]}'Klassifiser feilen
- 4xx krever vanligvis at en nøkkel, inndata eller tilgang korrigeres.
- 429 krever at grensevinduet respekteres og at aggressive nye forsøk unngås.
- 5xx-feil og nettverksfeil krever et begrenset antall nye forsøk med eksponentiell ventetid og tilfeldig variasjon.
Prøv trygt på nytt
Prøv bare midlertidige feil på nytt, og bare dersom operasjonen er idempotent i produktet ditt. Ved generering må du beholde en klientforespørsels-ID for å hindre dobbeltbelastning eller et duplisert artefakt.
Ved strømming må du skille mellom en feil før det første deltaet og et avbrudd etter delvise utdata: sistnevnte kan ikke erstattes i det skjulte med et nytt svar.