İstek Limitleri V1
İstek Hızı ve Kapsamı
120 istek / dakika / IP
Bulbulustur Developer API'de fixed politikası etkin public endpointlerde IP başına dakikada 120 istek uygulanır. Kimlik bilgisi doğrulama endpointi (/api/Credential/authenticate) ayrı bir kotaya sahiptir: IP başına dakikada 20 istek.
Kota tablosu
| İstek sınıfı | Limit | Pencere |
|---|---|---|
Genel API, fixed politikası | 120 istek / IP | 60 saniye |
| Kimlik bilgisi doğrulama | 20 istek / IP | 60 saniye |
Bu politika API anahtarı başına değil, istemci IP'si başına uygulanır. Aynı IP'den çalışan farklı entegrasyonlar kotayı paylaşabilir. Rate-limit politikası uygulanmayan yollar için bu rakamların geçerli olduğu varsayılmamalıdır.
Sayfa boyutu sınırları farklıdır: Limitler bölümünü inceleyin.
Limit Aşımı ve 429
Fixed window · Retry davranışı
Sabit pencere uygulaması her istemci IP'sine bir dakikalık istek bütçesi sağlar. Pencere içinde izin verilen sayı dolduğunda sonraki istekler 429 Too Many Requests döndürür. QueueLimit = 0; aşılan istekler otomatik olarak kuyruğa alınmaz.
429 alındığında
İsteği hemen tekrar etmeyin. Retry-After başlığı varsa ona uyun; mevcut uygulamada bu başlığın her yanıtta bulunacağı garanti değildir. Başlık yoksa artan bekleme ve küçük rastgele sapma (jitter) uygulayın.
Örnek yeniden deneme aralıkları istemci politikasına göre 1, 2, 4 ve 8 saniye olabilir; bunlar sunucunun vaat ettiği kesin açılma süreleri değildir. Yeniden deneme sayısını sınırlayın.
401 gibi kimlik doğrulama hatalarında bu yeniden deneme stratejisini kullanmayın; önce kimlik bilgilerini düzeltin.
Detaylı HTTP durumları için Hata Kodları bölümüne bakın.
Entegrasyon Stratejisi
İstek planlama ve izleme
İstemci için uygulama önerileri
1. Merkezi hız sınırlayıcı: Aynı çıkış IP'sini kullanan worker'ların isteklerini ortak bir bütçeyle koordine edin. Dakikalık 120 isteğin tamamını sürekli tüketmeye yönelik tasarım yerine güvenlik payı bırakın.
2. Listeleme: Sayfalı endpointleri page ve size ile kullanın. Gereksiz tekrar sorguları azaltın; güncellemelerin hangi sıklıkta gerekli olduğunu iş akışına göre belirleyin.
3. İzleme: HTTP statüsü, istek yolu, UTC zamanı ve tekrar deneme sayısını kaydedin. API Key veya API Secret değerlerini loglamayın.
4. Hata ayrımı: 429 için hız azaltma, 5xx için sınırlı ve güvenli retry; 400/401 için istek düzeltme uygulayın.
Belirli bir mağazaya ayrılmış ayrı IP kotası, garantili RateLimit-* yanıt başlıkları veya kuyruk/rezervasyon sistemi bu V1 sözleşmesinde tanımlı değildir.