Preberite celoten odgovor
Pri neuspešnem stanju po odstranitvi skrivnosti ohranite kodo HTTP, glave, telo napake in identifikator zahteve. Tako lahko ločite neveljavno zahtevo od zavrnitve dostopa ali začasne težave.
Neobdelanega odgovora storitve ne prikazujte kot edinega sporočila uporabniku: pojasnite dejanje, diagnostične podrobnosti pa ohranite za upravljavca.
Preglejte neuspešen odgovor
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":[]}'Razvrstite napako
- 4xx običajno zahteva popravek ključa, vhodnih podatkov ali dostopa.
- 429 zahteva upoštevanje časovnega okna omejitve in izogibanje agresivnim ponovnim poskusom.
- Napake 5xx in omrežne napake zahtevajo omejeno število ponovnih poskusov z eksponentnim podaljševanjem čakanja in naključnim zamikom.
Varno ponovite
Ponovno poskusite le pri prehodnih napakah in le, če je postopek v vašem izdelku idempotenten. Pri ustvarjanju ohranite identifikator zahteve odjemalca, da preprečite dvojno zaračunavanje ali podvojen artefakt.
Pri pretakanju ločite napako pred prvim delčkom od prekinitve po delnem izhodu: slednje ni mogoče neopazno nadomestiti z novim odgovorom.