Sınırı gösteren başlıklar
| Başlık | Anlamı | Dokümandaki örnek |
|---|---|---|
| X-Api-Call-Limit | Saniyedeki istek sayısı | Değer verilmemiş |
| Retry-After | Yeniden denemeden önce beklenecek saniye | 2.0 |
Dokümanda servis bazında ayrı bir sayı yoktur. Değeri koda gömmek yerine her yanıttaki başlığı okuyun. Retry-After başlığının genel tanımı MDN Retry-After sayfasında, 429 durumunun anlamı MDN 429 sayfasında bulunur.
Toplu servisler istek sayısını azaltır
idefix'in yazma servislerinin çoğu tek istekte birden çok kalem kabul eder. Her ürün için ayrı istek atmak, sınıra en hızlı ulaşmanın yoludur.
| İş | Toplu servis | Tek istekte |
|---|---|---|
| Stok ve fiyat | inventory-upload | items dizisinde çok sayıda barkod |
| Ürün oluşturma | create | En fazla 200 ürün |
| Hızlı listeleme | fast-listing | items dizisinde çok sayıda barkod |
| Eşleşme onayı | approve-item | items dizisinde barkod listesi |
| Sonuç sorgusu | batch-result, inventory-result, fast-listing-result | Bir partinin tüm kalemleri |
idefix SSS'ye göre bir ürün oluşturma isteğinde en fazla 200 ürün gönderilir ve bir partiden en fazla 200 kalem döner. Stok ve fiyat için dokümanda kalem sınırı yazmaz; büyük listeleri makul parçalara bölmek en güvenli yoldur.
Önerilen yeniden deneme düzeni
- 429 alınca Retry-After değerini okuyun ve en az o kadar bekleyin.
- Başlık gelmezse birkaç saniye bekleyin; hemen yeniden denemeyin.
- Bekleme sırasında aynı servise paralel istek atmayın.
- Deneme sayısını sınırlayın, örneğin üç. Sonra işi kuyruğa geri koyun.
- Sayfalı listelerde sayfalar arasına kısa bir ara koyun.
- Toplu sonucu sorgularken partinin bitmesini bekleyin; aralıksız sorgu sınırı hızla doldurur.
429 kalıcı bir hata değildir; aynı istek beklenen süreden sonra yeniden gönderilebilir. 401 ise kimlik sorunudur ve beklemekle düzelmez; ayrımı hata kodları sayfasında bulabilirsiniz.
Sık hatalar ve çözümleri
| Hata | Sonuç | Doğrusu |
|---|---|---|
| Retry-After'ı yok sayıp hemen yeniden denemek | Art arda 429 | Başlıktaki süre kadar beklemek |
| Her ürün için ayrı stok isteği | Sınıra hızla ulaşma | inventory-upload ile toplu gönderim |
| batch-result'u döngüde aralıksız sorgulamak | Gereksiz istek ve 429 | Birkaç saniye arayla, sınırlı sayıda sorgu |
| 429'u kalıcı hata sayıp işi bırakmak | Güncelleme kaybı | Bekleyip yeniden denemek |
| Birden çok sunucudan aynı mağazaya istek | Sınır paylaşılır, beklenmedik 429 | İstekleri tek kuyruktan göndermek |
Stok güncellemelerinde istek sayısını düşürmenin en etkili yolu değişiklikleri biriktirmektir. Her satıştan hemen sonra tek barkod göndermek yerine birkaç dakikalık değişiklikleri tek inventory-upload isteğinde toplayın. Böylece hem sınıra takılmazsınız hem de işlem kuyruğu kısalır. Stok tutarlılığının genel mantığı için pazaryeri stok senkronu rehberine bakabilirsiniz.
Sık sorulanlar
idefix API'de saniyede kaç istek atılabilir?
idefix sabit bir sayı yayımlamıyor. İzin verilen saniyelik istek sayısı X-Api-Call-Limit yanıt başlığında döner; kodunuz bu değeri okumalıdır.
429 hatası alınca ne kadar beklemeliyim?
Retry-After başlığındaki saniye kadar. Dokümandaki örnek değer 2.0 saniyedir.
Bir istekte kaç ürün oluşturabilirim?
idefix SSS'ye göre ürün oluşturma isteğinde en fazla 200 ürün gönderilebilir. Bir partinin sonucunda da en fazla 200 kalem döner.
429 hesabımın engellendiği anlamına gelir mi?
Hayır. 429 geçici bir yanıttır; beklenen süre sonunda aynı istek yeniden gönderilebilir.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı