Xatoliklar

Status kodlari

Kod	Ma’nosi	Yechilishi mumkin
200	Muvaffaqiyat. Yechim 0 bo’lishi mumkin.	✅ Ha
400	Bad request. Balans yetishmaganda ham qaytariladi.	❌ Yo’q
401	Api-Key yo’q yoki noto’g’ri.	❌ Yo’q
404	Resurs topilmadi.	❌ Yo’q
422	So’rov validatsiyasi xatosi.	❌ Yo’q
429	Daqiqalik yoki bir vaqtdagi so’rovlar cheklovi oshirildi.	❌ Yo’q
500	Xizmatning ichki xatosi.	❌ Yo’q
503	Xizmat vaqtincha ishlamayapti.	❌ Yo’q

Xato formati

Validatsiya xatolaridan tashqari hujjatlashtirilgan API xatolari detail qatorini qaytaradi:

{ "detail": "Xato tavsifi" }

Validatsiya xatoliklari (422) FastAPI uslubidagi strukturani qaytaradi:

{
  "detail": [
    {
      "loc": ["query", "name"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

• loc — xato maydonga yo’l.
• msg — odamga o’qiladigan xabar.
• type — xatolikning dasturiy turi.

Misollar

401 — token yo’q yoki noto’g’ri

{ "detail": "Not authenticated" }

400 — balans yetishmaydi

{ "detail": "Not enough balance to perform this action. Please top up your balance." }

Pullik endpointda balans yetishmasa, javobda Telesint-Billing-Charged: 0, Telesint-Billing-Balance va Cache-Control: private, no-store ham bo’ladi. Boshqa 400, 404, 422, 500 va 503 javoblarida billing sarlavhalari kafolatlanmaydi.

404 — resurs topilmadi

{ "detail": "User not found" }

429 — so’rov cheklovi oshirildi

{ "detail": "Rate limit exceeded", "reason": "rpm" }

Javobda Retry-After bo’ladi. reason qiymati rpm yoki concurrency; batafsil So’rov cheklovlari sahifasida.

503 — cheklovchi mavjud emas

{ "detail": "Rate limiter is temporarily unavailable" }

Bu javobda Retry-After: 5 bo’ladi va haq olinmaydi.

Qayta urinish strategiyasi

Status	Qayta urinish?
2xx	—
400, 401, 404, 422	Yo’q. So’rovni / tokenni / balansni tuzating, so’ng qayta urinib ko’ring.
429	Ha. Retry-After dagi soniyalardan keyin qayta urinib ko’ring.
5xx	Ha. Retry-After bo’lsa unga amal qiling; aks holda backoff: 1s, 2s, 4s, 8s.