Xatolar
HTTP status kodlar, xato JSON formatlari va integratsiyada tekshiriladigan xavfsizlik holatlari.
HTTP status kodlar
200OKSo'rov muvaffaqiyatli bajarildi
304Not ModifiedMa'lumot o'zgarmagan (ETag + If-None-Match)
401UnauthorizedCredential headerlar yo'q yoki noto'g'ri
403ForbiddenKalit nofaol, ability yetarli emas, yoki IP ruxsatsiz
404Not FoundEndpoint yo'q yoki ma'lumot topilmadi
422UnprocessableMajburiy parametr yo'q yoki noto'g'ri qiymat
429Too Many RequestsRate limit oshdi — Retry-After soniya kuting
5xxServer ErrorServer ichki xatosi — exponential backoff bilan qayta urinib ko'ring
Xato formati
JSON
{
"status": "error",
"message": "Invalid or inactive API credentials"
}
Tez-tez uchraydigan xatolar
| Xato xabari | Sabab va yechim |
|---|---|
| API credentials missing | Headerlar umuman yuborilmagan — ikkala headerni ham qo'shing |
| Invalid or inactive API credentials | Secret noto'g'ri yoki kalit o'chirilgan — bizga murojaat qiling |
| IP address not allowed for this API key | Server IP allowlistda yo'q — kerakli IP ni bildiring |
| Missing ability: stock:write | Kalit faqat read — stock:write kalit so'rang |
| This API key is not scoped to a seller | Seller API uchun do'koningizga bog'langan alohida kalit kerak |
| ISBN not found in your store | Bu ISBN siz boshqaradigan do'konda ro'yxatdan o'tmagan |
Integratsiya checklisti
- App ID va Secret faqat server muhit o'zgaruvchilarida saqlangan
- Barcha API so'rovlar server tomonidan yuborilmoqda (frontend'dan emas)
- POST so'rovlarda Idempotency-Key header yuborilmoqda
- 429 holati uchun Retry-After headeriga asoslangan kutish mexanizmi bor
- ETag saqlash va If-None-Match bilan 304 optimizatsiya qilingan