Čtení celé odpovědi
U neúspěšného stavu uchovejte po odstranění tajných údajů kód HTTP, hlavičky, tělo chyby a ID požadavku. Pomohou rozlišit neplatný požadavek od zamítnutí přístupu nebo dočasného problému.
Nezobrazujte neupravenou odpověď služby jako jedinou zprávu uživateli: vysvětlete akci a současně uchovejte diagnostické podrobnosti pro operátora.
Kontrola neúspěšné odpovědi
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":[]}'Klasifikace selhání
- 4xx obvykle vyžaduje opravu klíče, vstupních dat nebo přístupu.
- 429 vyžaduje respektování okna limitu a vyvarování se agresivního opakování.
- Chyby 5xx a síťová selhání vyžadují omezené opakování s exponenciálním prodlužováním a náhodným rozptylem.
Bezpečné opakování
Opakujte pouze přechodná selhání a jen tehdy, je-li operace ve vašem produktu idempotentní. U generování uchovávejte ID požadavku klienta, abyste zabránili dvojímu účtování nebo duplicitnímu artefaktu.
Při streamování rozlišujte chybu před první deltou od přerušení po částečném výstupu: druhý případ nelze bez upozornění nahradit novou odpovědí.