Hız Sınırlaması (Rate Limiting)
Partner API, adil kullanım ve platform kararlılığını sağlamak için hız sınırları uygular.
Varsayılan Sınırlar
| Uç Nokta | Sınır (Üretim) | Sınır (Sandbox) |
|---|---|---|
| Genel uç noktalar | 100 istek/dk | 500 istek/dk |
Sipariş oluşturma (POST /orders) | 10 istek/dk | 50 istek/dk |
Yanıt Başlıkları (Response Headers)
Her API yanıtı, aşağıdaki başlıklarda hız sınırı bilgilerini içerir:
| Başlık | Açıklama |
|---|---|
X-RateLimit-Limit | Mevcut pencerede izin verilen maksimum istek sayısı |
X-RateLimit-Remaining | Mevcut pencerede kalan istek sayısı |
X-RateLimit-Reset | Hız sınırı penceresinin sıfırlandığı Unix zaman damgası (saniye) |
429 Yanıtlarını Yönetme
Hız sınırını aştığınızda API, 429 Too Many Requests yanıtı döndürür:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Önerilen Strateji
- Kullanımınızı proaktif olarak izlemek için
X-RateLimit-Remainingbaşlığını okuyun. 429yanıtı aldığınızda, yeniden denemeden önceX-RateLimit-Resetile belirtilen zamana kadar bekleyin.- Tekrarlanan kısıtlamayı önlemek için yeniden denemelerde üstel geri çekilme (exponential backoff) uygulayın.
- Gereksiz istekleri azaltmak için ürün kataloğu yanıtlarını mümkün olduğunca önbelleğe alın.