Rate limit, API'nin "dakikada en fazla şu kadar istek" kuralıdır. Platformlar sunucularını korumak ve tüm satıcılara adil hizmet vermek için bu sınırı koyar. Sınırı aşan yazılım bir süre yanıt alamaz; ürün, stok ya da sipariş işlemleri gecikir.
Sınır aşılınca ne olur?
Standart yanıt HTTP 429 Too Many Requests kodudur. Bu kod RFC 6585 ile tanımlanmıştır. Sunucu yanıtta Retry-After başlığıyla ne kadar beklenmesi gerektiğini de söyleyebilir. Doğru davranış, bu süre kadar bekleyip isteği yeniden göndermektir.
Gerçek bir örnek: Trendyol servis limitleri
Trendyol limitleri servis bazında, dakika ya da saat cinsinden yayımlar. Servis limitleri sayfasından birkaç satır:
| Servis | Limit |
|---|---|
| İade ve sevkiyat adres bilgileri | Saatte 1 istek |
| Ürün silme | Dakikada 100 istek |
| İade siparişlerini onaylama | Dakikada 5 istek |
| Sipariş paketlerini çekme | Mağaza seviyesine göre dakikada 30–100 istek |
Fiyat güncellemede ayrıca barkod başına dakikada 30 istek sınırı vardır; aşılırsa hata toplu işlem sonucunda o barkod için görünür. Aynı sayfa, 14 Eylül 2026 sonrası için servisleri gruplara ayırır ve limiti grup genelinde ortak sayar. Rakamlar değişebildiği için kod yazmadan önce güncel tabloyu kontrol edin.
Sınıra takılmamak için
- Toplu uç nokta kullanın. Yüz ürünün stoğunu yüz ayrı istekle değil, tek bir toplu işlem isteğiyle gönderin.
- Değişmeyeni göndermeyin. Stok değişmediyse güncelleme isteği atmayın.
- Üstel bekleme uygulayın. 429 alınca hemen tekrar denemek yerine bekleme süresini her denemede artırın.
- İstekleri yayın. Gece toplu iş çalıştırıyorsanız istekleri tek saniyeye yığmayın.
- Önbellek kullanın. Kategori ağacı gibi nadir değişen verileri her seferinde yeniden çekmeyin.
Satıcı için anlamı
Rate limit, panelde "stok neden geç güncellendi?" sorusunun sık cevabıdır. Aynı API anahtarını birden fazla yazılıma verdiyseniz limit bu yazılımlar arasında paylaşılır ve hepsi yavaşlar. Saystok'un idefix, Pazarama, Shopify ve ikas bağlantıları ile Trendyol finans sorguları 429 aldığında bekleyip yeniden dener.