Kitobchi API v1
OpenAPI Postman Kitobchi.com

Limit va cache

So‘rov limitlari (Rate Limiting), response cache, ETag va 304 Not Modified optimizatsiyasi.

Limitlar

Har bir API kalit uchun standart limitlar:

DavrLimit
1 soniya8 so'rov
1 daqiqa240 so'rov

Limit oshib ketsa HTTP 429 Too Many Requests qaytariladi. Retry-After headeridagi soniya qadar kuting.


Rate-limit headerlar

HeaderMa'nosi
X-RateLimit-Limit-Second1 soniyadagi ruxsat etilgan so'rovlar soni
X-RateLimit-Limit-Minute1 daqiqadagi ruxsat etilgan so'rovlar soni
X-RateLimit-Remaining-SecondJoriy soniyadagi qolgan kvota
X-RateLimit-Remaining-MinuteJoriy daqiqadagi qolgan kvota
Retry-After429 holati — kutish vaqti (soniya)

Response keshi

GET endpointlar avtomatik ravishda 120 soniya keshlanadi. Har bir javobda X-API-Cache headeri bo'ladi:

QiymatMa'nosi
MISSKeshda yo'q edi — yangi javob yaratildi va saqlandi
HITKeshdan qaytarildi
BYPASSKesh o'tkazib yuborildi (POST yoki Cache-Control: no-cache)

ETag va 304

Bandwidth tejash uchun conditional request'lardan foydalaning:

1-so'rov — ETag saqlang
HTTP/1.1 200 OK
ETag: "a3f5c8e9b1d2..."
Content-Type: application/json
2-so'rov — If-None-Match yuboring
GET /products/books HTTP/1.1
If-None-Match: "a3f5c8e9b1d2..."

→ HTTP/1.1 304 Not Modified  (body yo'q, trafik tejaldi)