O‘zgarishlar
API versiyalash tarixi, yangilanishlar va kelajakdagi breaking change siyosati.
Versiyalash siyosati
API versiyasi URL'da ko'rsatiladi: /api/v1/client/. Breaking change bo'lganda yangi versiya e'lon qilinadi va eski versiya kamida 6 oy parallel ishlashda qoladi. Non-breaking yangiliklar (yangi endpointlar, yangi response maydonlar) joriy versiyaga qo'shiladi.
v1.2 — Sentyabr 2026
v1.2.0
Latest
19 Sentyabr 2026
- GET /products/mine — seller o'z do'konining mahsulotlari va zaxirasini ko'rishi uchun yangi endpoint
- GET /deeplink — mobil va web uchun smart URL generator
- ETag + 304 kesh mexanizmi barcha GET endpointlarga qo'shildi
- Idempotency-Key header POST so'rovlarda 24 soat keshlanadi
- by-publisher endpointidagi pagination muammosi tuzatildi
v1.1 — Iyun 2026
v1.1.0
14 Iyun 2026
- POST /products/stock/by-code — ISBN va shtrix-kod bo'yicha zaxira yangilash (stock:write)
- IP allowlist — kalitlarga server IP biriktirish imkoniyati
- X-API-Cache header: MISS / HIT / BYPASS holatlari
- Rate limit headerlar yangilandi
- seller_id filter parametridagi xato tuzatildi
v1.0 — Yanvar 2026
v1.0.0
5 Yanvar 2026
- Birinchi rasmiy reliz
- Products endpointlari: books, stationery, recommendations, authors, publishers, sellers
- Search: global, suggestions, trending, categories
- X-App-ID + X-App-Secret autentifikatsiya tizimi
- OpenAPI 3.0 va Postman Collection eksport