Толық жауапты оқу
Сәтсіз күй үшін құпияларды алып тастағаннан кейін HTTP кодын, тақырыптарды, қате денесін және сұрау идентификаторын сақтаңыз. Олар жарамсыз сұрауды қолжетімділіктен бас тартудан немесе уақытша мәселеден ажыратады.
Қызметтің өңделмеген жауабын пайдаланушыға жіберілетін жалғыз хабар ретінде көрсетпеңіз: операторға арналған диагностикалық мәліметтерді сақтай отырып, әрекетті түсіндіріңіз.
Сәтсіз жауапты тексеру
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":[]}'Ақауды жіктеу
- 4xx әдетте кілтті, кіріс деректерін немесе қолжетімділікті түзетуді талап етеді.
- 429 шектеу терезесін сақтауды және тым жиі қайталамауды талап етеді.
- 5xx және желі ақаулары экспоненциалды кідіріс пен кездейсоқ ауытқуы бар шектеулі қайталауды талап етеді.
Қауіпсіз қайталау
Уақытша ақауларды ғана және операция өніміңізде идемпотентті болғанда ғана қайталаңыз. Генерация үшін екі рет ақы алуды немесе қайталанған артефактіні болдырмау мақсатында клиент сұрауының идентификаторын сақтаңыз.
Ағынмен жіберуде алғашқы дельтаға дейінгі қатені жартылай шығыстан кейінгі үзілістен ажыратыңыз: соңғысын жаңа жауаппен үнсіз ауыстыруға болмайды.