Prečítajte celú odpoveď
Pri neúspešnom stave po odstránení tajných údajov uchovajte kód HTTP, hlavičky, telo chyby a ID požiadavky. Umožňujú odlíšiť neplatnú požiadavku od odmietnutia prístupu alebo dočasného problému.
Nesprístupňujte surovú odpoveď služby ako jedinú správu pre používateľa: vysvetlite úkon a diagnostické podrobnosti zachovajte pre operátora.
Preskúmajte neúspešnú odpoveď
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":[]}'Klasifikujte zlyhanie
- 4xx zvyčajne vyžaduje opraviť kľúč, vstupné údaje alebo prístup.
- Chyba 429 vyžaduje rešpektovať časové okno limitu a vyhnúť sa agresívnemu opakovaniu.
- Chyby 5xx a zlyhania siete vyžadujú ohraničené opakovania s exponenciálnym predlžovaním intervalov a náhodným rozptylom.
Opakujte bezpečne
Opakujte iba dočasné zlyhania a iba vtedy, ak je úkon vo vašom produkte idempotentný. Pri generovaní uchovajte ID požiadavky klienta, aby ste zabránili dvojitému účtovaniu alebo duplicitnému artefaktu.
Pri streamovaní rozlišujte chybu pred prvým prírastkom od prerušenia po čiastočnom výstupe: druhý prípad nemožno potichu nahradiť novou odpoveďou.