Perskaitykite visą atsakymą
Gavę nesėkmingą būseną, pašalinę paslaptis išsaugokite HTTP kodą, antraštes, klaidos turinį ir užklausos identifikatorių. Jie padeda atskirti netinkamą užklausą nuo prieigos atmetimo ar laikinos problemos.
Nerodykite neapdoroto paslaugos atsakymo kaip vienintelio pranešimo naudotojui: paaiškinkite veiksmą, o diagnostines detales išsaugokite operatoriui.
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":[]}'Klasifikuokite klaidą
- 4xx paprastai reiškia, kad reikia pataisyti raktą, įvesties duomenis arba prieigą.
- Gavus atsakymą 429, reikia paisyti apribojimo laikotarpio ir vengti agresyvių pakartotinių bandymų.
- 5xx ir tinklo klaidų atveju reikia riboto skaičiaus pakartotinių bandymų su eksponentiškai ilgėjančiu laukimo intervalu ir atsitiktiniu jo svyravimu.
Saugiai pakartokite
Pakartokite tik laikinai nepavykusias operacijas ir tik jei jūsų produkte operacija yra idempotentinė. Generuodami išsaugokite kliento užklausos identifikatorių, kad išvengtumėte dvigubo apmokestinimo arba pasikartojančio artefakto.
Srautinio perdavimo metu atskirkite klaidą prieš pirmąjį dalinį atsakymą nuo nutrūkimo jau gavus dalį išvesties: pastarosios negalima nepastebimai pakeisti nauju atsakymu.