cicora.ai
API spetsifikatsiyasiXatolar va sozlash

Xatolar va sozlash

Xabar matniga emas, HTTP status, tuzilgan xato tanasi va request id ga qarab ishlov bering.

Integratsiya ma’lumotnomasi: muhitingiz uchun parametrlar va mavjud imkoniyatlarni akkaunt API sozlamalari hamda model katalogidan tanlang.

To‘liq javobni o‘qing

Muvaffaqiyatsiz statusda maxfiylarni olib tashlagach HTTP kodi, sarlavhalar, xato tanasi va request id ni saqlang. Ular noto‘g‘ri so‘rovni kirish rad etilishi yoki vaqtinchalik muammodan ajratadi.

Foydalanuvchiga servisning xom javobini yagona matn sifatida ko‘rsatmang: operator uchun diagnostika tafsilotlarini saqlagan holda harakatni tushuntiring.

Inspect a failed response
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":[]}'

Tasniflash

  • 4xx odatda kalit, kirish ma’lumotlari yoki ruxsatni tuzatishni talab qiladi.
  • 429 limit oynasini hisobga olishni va tajovuzkor qayta urinishni boshlamaslikni talab qiladi.
  • 5xx va tarmoq xatolari eksponensial pauza hamda tasodifiy tarqalish bilan cheklangan qayta urinishni talab qiladi.

Xavfsiz qayta urinish

Faqat vaqtinchalik nosozliklarni va mahsulotingizda operatsiya idempotent bo‘lsa qayta urining. Generatsiya uchun ikki marta hisoblash yoki artefakt takrorlanishini oldini olishga client request id saqlang.

Oqimda birinchi deltadan oldingi xato va qisman chiqishdan keyingi uzilishni ajrating: ikkinchi holatni yangi javob bilan sezilmasdan almashtirib bo‘lmaydi.