Limitler V1
Genel Bakış
API kaynaklarının verimli ve güvenli kullanımı
Bulbulustur Developer API'de istek hızı, sayfalama ve işlem sınırları ayrı ayrı değerlendirilir. Doğrulanmamış genel kotalar belirtilmez; her endpointin referansı esas alınır.
Listeleme ve Sayfalama
Büyük veri kümelerinin kontrollü olarak alınması
Sayfalama destekleyen endpointler page ve size alabilir. Referans verileri yalnız size kullanabilir. Her endpointin kendi varsayılan ve maksimum değerlerini dikkate alın. Örnek: GET /api/brands varsayılan 50, en fazla 100 kayıt döndürür; bütün endpointler için genel kural değildir.
İstek ve Veri Boyutu
HTTP isteklerinin ve gönderilen verilerin boyut sınırları
Tüm public endpointlere ortak, doğrulanmış tek bir MB üst sınırı yoktur. Veri boyutu ve alan kısıtları için endpoint sözleşmesini kullanın. 413 alınırsa isteği küçültün.
Toplu İşlemler
Ürün, stok ve fiyat güncellemelerinde işlem kapsamı
V1 için ortak bir toplu işlem kotası doğrulanmadı. Toplu yazma ya da güncelleme yalnız ilgili public endpointte tanımlanmışsa kullanılabilir.
Eşzamanlı İşlemler
Paralel API istekleri ve veri tutarlılığı
Ortak bir paralel istek kotası doğrulanmadı. Aynı istemci IP'sindeki istekler hız limitini paylaşır. 429 durumunda kontrollü tekrar deneyin.
Mağaza ve Kaynak Kotaları
Hesap, mağaza ve kaynak bazında kullanım sınırları
Ürün, sipariş veya depolama için bütün mağazalara ortak doğrulanmış bir kota yayımlanmamıştır. Mağaza erişimi API anahtarıyla kontrol edilir. Kaynak limiti varsa endpoint referansında belgelenir.
Limit Aşımı ve Entegrasyon Yönetimi
Kaynak sınırlarına uygun hata yönetimi
İstek Hızı
Sabit 1 dakikalık pencere.
/api/Credential/authenticate ayrı limit kullanır.
Limit politikası etkin endpointlerde aşım yanıtı 429 Too Many Requests; kuyruk kapasitesi sıfırdır. İstemci, artan bekleme ve rastgele gecikmeyle yeniden denemelidir.
Proxy veya ağ geçidi ilave sınırlar uygulayabilir.