Xatolar

API standart HTTP status kodlaridan foydalanadi. Xato javobi har doim bir xil tuzilishda qaytadi.

Xato obyekti

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_parameter",
    "message": "params.topic majburiy.",
    "param": "params.topic",
    "request_id": "req_4c1a77"
  }
}

typestring

Xato guruhi. Dasturda shu bo'yicha tarmoqlang.

codestring

Aniq sabab kodi. Matn emas, shu kodga tayaning.

messagestring

Odam o'qishi uchun izoh. U o'zgarishi mumkin.

paramstring | null

Xatoga sabab bo'lgan maydon.

request_idstring

Support'ga murojaat qilganda shu identifikatorni yuboring.

HTTP status kodlari

Status	`code`	Ma'nosi
400	`missing_parameter`, `invalid_parameter`	So'rov noto'g'ri tuzilgan.
401	`invalid_api_key`	Kalit yo'q yoki bekor qilingan.
402	`insufficient_credits`	Bu xizmat bo'yicha kredit yetarli emas. Hech narsa yechilmaydi.
403	`service_not_enabled`	Xizmat hisobingiz uchun yoqilmagan.
404	`not_found`	Obyekt topilmadi yoki sizga tegishli emas.
409	`idempotency_conflict`, `order_not_cancelable`	Holat bilan ziddiyat.
410	`file_expired`	Fayl saqlash muddati tugagan.
422	`source_too_short`, `topic_rejected`	So'rov to'g'ri, lekin mazmuni qabul qilinmadi.
429	`rate_limited`	Limitdan oshdingiz. Limitlar.
500, 503	`server_error`, `unavailable`	Bizning tomonda xato. Qayta urinib ko'ring.

Buyurtma xatolari

Buyurtma yaratilgach ham xato bo'lishi mumkin. Bunda status: "failed" bo'ladi, kredit qaytariladi, sabab error maydonida ko'rsatiladi:

{
  "id": "ord_8f3a1c9e2b",
  "status": "failed",
  "refunded": true,
  "error": { "code": "generation_failed", "message": "Hujjatni tayyorlab bo'lmadi. Kredit qaytarildi." }
}

Qayta urinish

5xx va 429 da qayta urining: 1, 2, 4, 8 soniya oralig'i bilan, ko'pi bilan 5 marta.
4xx (429 dan tashqari) da so'rovni o'zgartirmay qayta yubormang, xato o'zi yo'qolmaydi.
Buyurtma yaratishda qayta urinishdan oldin Idempotency-Key ishlatganingizga ishonch hosil qiling, aks holda kredit ikki marta yechilishi mumkin.