A teljes válasz beolvasása
Sikertelen állapotnál a titkok eltávolítása után őrizze meg a HTTP-kódot, fejléceket, hibatörzset és kérésazonosítót. Ezek különböztetik meg az érvénytelen kérést a hozzáférés elutasításától vagy átmeneti hibától.
Ne nyers szolgáltatásválaszt használjon egyetlen felhasználói üzenetként: magyarázza el a műveletet, a diagnosztikai részleteket pedig őrizze meg az üzemeltetőnek.
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":[]}'A hiba besorolása
- A 4xx általában a kulcs, a bemeneti adatok vagy a hozzáférés javítását igényli.
- A 429 megköveteli a korlát időablakának tiszteletben tartását és az agresszív újrapróbálkozás kerülését.
- Az 5xx és hálózati hibák korlátozott számú, exponenciális késleltetésű és véletlen eltérést alkalmazó újrapróbálkozást igényelnek.
Biztonságos újrapróbálkozás
Csak átmeneti hibát próbáljon újra, és csak akkor, ha a művelet a termékben idempotens. Generálásnál őrizzen meg kliensoldali kérésazonosítót, hogy elkerülje a kétszeres díjterhelést vagy az ismétlődő műterméket.
Streameléskor különböztesse meg az első változásrész előtti hibát a részleges kimenet utáni megszakadástól: az utóbbi nem helyettesíthető észrevétlenül új válasszal.