cicora.ai
API-specificatieBetrouwbaarheid

Fouten en debuggen

Bouw de verwerking rond de HTTP-status, een gestructureerde foutinhoud en aanvraag-ID, niet rond berichttekst.

Integratiereferentie: kies parameters en beschikbare mogelijkheden uit de API-instellingen van uw account en de modelcatalogus voor uw omgeving.

Het volledige antwoord lezen

Bewaar bij een mislukte status de HTTP-code, headers, foutinhoud en aanvraag-ID nadat geheimen zijn verwijderd. Daarmee onderscheidt u een ongeldige aanvraag van geweigerde toegang of een tijdelijk probleem.

Toon een ruw serviceantwoord niet als het enige gebruikersbericht: leg de actie uit en bewaar diagnostische details voor een operator.

Een mislukt antwoord inspecteren
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":[]}'

De fout classificeren

  • Een 4xx-fout vereist doorgaans correctie van een sleutel, invoergegevens of toegang.
  • Bij 429 moet u het limietvenster respecteren en agressieve nieuwe pogingen vermijden.
  • Bij 5xx- en netwerkfouten zijn begrensde nieuwe pogingen met exponentiële vertraging en jitter nodig.

Veilig opnieuw proberen

Probeer alleen tijdelijke fouten opnieuw en alleen als de bewerking in uw product idempotent is. Bewaar voor generatie een clientaanvraag-ID om te voorkomen dat kosten dubbel in rekening worden gebracht of een artefact dubbel wordt gemaakt.

Maak bij streaming onderscheid tussen een fout vóór de eerste delta en een onderbreking na gedeeltelijke uitvoer: die laatste kan niet ongemerkt worden vervangen door een nieuw antwoord.