Xatolar
Xatolar formati va kodlari.
Har qanday xato 4xx/5xx HTTP statusi va quyidagi tana bilan qaytadi:
{
"success": false,
"error": {
"code": -1007,
"type": "validation",
"message": "So'rov maydonlarini tekshiring",
"details": [{ "field": "quantity", "message": "Kamida 50" }]
},
"meta": { "requestId": "8e3c…", "timestamp": "2026-09-26T10:15:30.000Z", "processingTimeMs": 3 }
}codebu barqaror raqamli kod, kodingizda aynan unga tayaning;messageo'zgarishi mumkin vaAccept-Languagebo'yicha tarjima qilinadi.details: maydonlar bo'yicha xatolar (faqat validatsiya uchun).data: xato haqida qo'shimcha ma'lumot, agar bo'lsa.meta.requestIdx-request-idsarlavhasi bilan bir xil, qo'llab-quvvatlash xizmatiga yozganda uni ko'rsating.
HTTP statuslari
| Status | Qachon | Nima qilish kerak |
|---|---|---|
400 | validatsiya xatosi (-1007), Idempotency-Key yo'q (-11001), noto'g'ri username (-9202), mahsulot (-9203) yoki externalId (-9204) | so'rovni tuzatish |
401 | kalit yo'q, noto'g'ri yoki bekor qilingan | X-API-Key ni tekshirish |
402 | balans yetarli emas (-9301) | balansni to'ldirish |
403 | IP Project allowlist'ida yo'q | server manzilini qo'shish |
404 | buyurtma topilmadi yoki boshqa Project'ga tegishli (-9201) | buyurtma id'sini tekshirish |
409 | shu Idempotency-Key bilan so'rov hali bajarilmoqda (-11003); externalId boshqa parametrli buyurtma tomonidan band (-9207) | keyinroq qayta urinish yoki buyurtmani tekshirish |
422 | qabul qiluvchi topilmadi (-9002), qabul qiluvchiga sovg'a qilib bo'lmaydi (-9003), Idempotency-Key boshqa tana bilan ishlatilgan (-11002) | xatoni xaridorga ko'rsatish yoki yangi kalit olish; o'zgartirmasdan takrorlamang |
429 | limit oshib ketdi (-11005) | Retry-After dan keyin qayta urinish |
502 | yetkazib beruvchi vaqtincha mavjud emas (-9006) | bir necha soniyadan keyin qayta urinish |
5xx | bizning tomonimizdagi xato | xuddi shu Idempotency-Key bilan qayta urinish |
Kodlar diapazonlari
| Kodlar | Soha |
|---|---|
-1000…-1999 | umumiy (validatsiya, kirish huquqi) |
-11001…-11099 | idempotentlik va limitlar |
-9001…-9099 | yetkazib beruvchi (qabul qiluvchi topilmadi, mavjud emas) |
-9201…-9299 | buyurtmalar |
-9301…-9399 | narxlar va balans |
-9101…-9199 | Supplier Accounts |
-9401…-9499 | vebxuklar |
Har bir metod uchun kodlarning to'liq ro'yxati API ma'lumotnomasida keltirilgan.