Asosiy qismga o'tish

Ma'lumotnoma · 10-bob

Xatolar va cheklovlar

Barcha xatolar bir xil ko'rinishda keladi, shuning uchun bitta ishlovchi yetarli. Bu bo'limda har bir xato kodi, unga qarshi nima qilish kerakligi va so'rov cheklovlari keltirilgan.

2 daqiqa o'qish

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, 503 va har qanday 5xx. Buyurtmalarni doim shu transaction_id bilan qayta yuboring.
  • O'zgartirmasdan qayta yubormang: 401, 403, 404, 409, 422 — avval so'rovni tuzating. 402 da 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.
Maslahat

Har bir buyurtmani siklda so'rab turmang. Webhooklar dan foydalaning va katalogni updated_since bilan yangilang — shunda cheklovdan ancha past bo'lasiz.