Xatolar
HTTP status kodlar, xato JSON formatlari va integratsiyada tekshiriladigan xavfsizlik holatlari.
HTTP status kodlar
200OKMuvaffaqiyatli
304Not ModifiedO'zgarmagan
401UnauthorizedKalit yuborilmagan
403ForbiddenRuxsat yo'q
404Not FoundTopilmadi
422UnprocessableParametr noto'g'ri
409ConflictKod bir nechta mahsulotga mos keldi
429Too Many RequestsSo'rov ko'p — Retry-After kuting
5xxServer ErrorServer xatosi
Xato formati
JSON
{
"status": "error",
"message": "Kalit noto'g'ri yoki o'chirilgan."
}
Tez-tez uchraydigan xatolar
| Xato xabari | Sabab va yechim |
|---|---|
| Kalit yuborilmagan. | Headerlar umuman yuborilmagan — ikkala headerni ham qo'shing |
| Kalit noto'g'ri yoki o'chirilgan. | Secret noto'g'ri yoki kalit o'chirilgan — Telegram guruhga murojaat qiling |
| Bu IP manzilga ruxsat yo'q. | Server IP allowlistda yo'q — kerakli IP ni bildiring |
| Ruxsat yetarli emas: stock:write | Kalit faqat read — stock:write kalit so'rang |
| Bu kalit do'konga bog'lanmagan. | Seller API uchun do'koningizga bog'langan alohida kalit kerak |
| Bu kod do'koningizda topilmadi. | Bu ISBN yoki artikul siz boshqaradigan do'konda yo'q |
| Bu ISBN bilan bir nechta nashr bor. | Bir xil ISBN turli nashrlarga tegishli — code sifatida 8 xonali artikul yuboring |
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