Xato formati
{
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Balance is 3.10 USD, the order costs 12.84 USD.",
"fields": { "player_id": "Required." }
}
}
Mantiqingizni code ga quring — u hech qachon o'zgarmaydi. message odamlar uchun va o'zgarishi mumkin. fields faqat tekshiruv xatolarida bo'ladi.
Xato kodlari
| Kod | HTTP | Ma'nosi va nima qilish kerak |
|---|---|---|
UNAUTHENTICATED |
401 | API kalit yo'q yoki yaroqsiz. |
IP_NOT_ALLOWED |
403 | Kalit bu IP dan ishlashga ruxsat etilmagan. Kalitning IP ro'yxatini tekshiring. |
ACCOUNT_NOT_ACTIVE |
403 | Hisobingiz tasdiqlanmagan yoki to'xtatilgan. |
SANDBOX_ONLY |
403 | Bu so'rov faqat test kaliti bilan ishlaydi (masalan POST /sandbox/balance). |
SANDBOX_LIMIT |
409 | Saqlangan test buyurtmalar juda ko'p; paneldan sandbox'ni tozalang yoki eskilari o'chishini kuting. |
VALIDATION_FAILED |
422 | So'rov yoki mijoz maydonlari noto'g'ri; fields ga qarang. |
NOT_FOUND |
404 | Noma'lum taklif yoki manzil. |
OFFER_NOT_FOUND |
404 | Buyurtmadagi offer_id noma'lum. |
INVALID_PLAYER |
422 | O'yinchi tekshiruvi: o'yinchi topilmadi. |
OFFER_UNAVAILABLE |
409 | Taklif hozir sotuvda yo'q. |
PRICE_CHANGED |
409 | Narx max_price qiymatingizdan yuqori yoki yetkazish paytida o'zgardi. Hech narsa yechilmagan; taklifni qayta o'qing. |
INSUFFICIENT_BALANCE |
402 | Balansingizni to'ldiring va qayta urinib ko'ring. |
TRANSACTION_ID_CONFLICT |
409 | Bu transaction_id boshqa buyurtma uchun ishlatilgan. |
ORDER_NOT_FOUND |
404 | Bu transaction_id bilan buyurtma yo'q. |
SUPPLIER_UNAVAILABLE |
503 | Vaqtincha mavjud emas; keyinroq qayta urinib ko'ring. |
RATE_LIMITED |
429 | So'rovlar juda ko'p; Retry-After soniya kuting. |
Bajarilmagan buyurtmalarda ham error.code bo'ladi: SUPPLIER_FAILED yoki SUBMIT_TIMEOUT. Ikkala holatda ham refunded qiymati true.
Nimani qayta yuborish mumkin
- Qayta yuborish xavfsiz: tarmoq xatolari, javob kutish vaqti tugashi,
429,503va har qanday5xx. Buyurtmalarni doim shutransaction_idbilan qayta yuboring. - O'zgartirmasdan qayta yubormang:
401,403,404,409,422— avval so'rovni tuzating.402da avval balansni to'ldiring.
So'rov cheklovlari
Har bir akkaunt daqiqasiga 120 ta so'rov yuborishi mumkin — barcha kalitlari birga. O'yinchi tekshiruvining o'z limiti bor: daqiqasiga 30 ta. Har bir javobda quyidagilar bor:
| Sarlavha | Ma'nosi |
|---|---|
X-RateLimit-Limit |
Daqiqasiga ruxsat etilgan so'rovlar. |
X-RateLimit-Remaining |
Joriy daqiqada qolgan so'rovlar. |
Retry-After |
Faqat 429 da: kutish kerak bo'lgan soniyalar. |
Har bir buyurtmani siklda so'rab turmang. Webhooklar dan foydalaning va katalogni updated_since bilan yangilang — shunda cheklovdan ancha past bo'lasiz.