Kota nasıl hesaplanır?
Etsy belgesine göre sınırlar uygulama düzeyindedir ve API anahtarına uygulanır; herkese açık ve OAuth'lu istekler aynı kotadan düşer (Etsy: Rate Limits). Uygulamanızın güncel sınırlarını geliştirici portalında görürsünüz; bu rehber sabit bir sayı vermez.
Günlük sınır kayan pencereyle işler. 24 saat küçük zaman dilimlerine bölünür. En eski dilim pencereden çıktığında o dilimde harcanan hak hemen geri gelir. Yani kotayı aşan bir uygulama ertesi günü beklemek zorunda değildir.
Yanıt başlıkları
Başarılı her yanıt kalan hakkınızı başlıklarda bildirir:
| Başlık | Anlamı |
|---|---|
| x-limit-per-second | Anahtarın saniyelik sınırı |
| x-remaining-this-second | Bu saniyede kalan istek |
| x-limit-per-day | Kayan 24 saatlik sınır |
| x-remaining-today | Pencerede kalan istek |
| retry-after | Yalnız 429'da; yeniden denemeden önce beklenecek tahmini saniye |
Etsy önce saniyelik, sonra günlük sınırı kontrol eder. İkisinden biri aşılırsa 429 döner. Belgede saniyelik kalan başlığının yazımı "x-remaining-this-secon" olarak geçiyor; kodunuzda iki yazımı da okumak sorun çıkarmaz.
Sayfalama: limit ve offset
Çok kayıt döndüren uçlar limit ve offset parametrelerini kullanır (Etsy: URL Syntax).
| Parametre | Varsayılan | Sınır | Not |
|---|---|---|---|
| limit | 25 | En fazla 100 | Sayfa başına kayıt |
| offset | 0 | En fazla 12000 | Atlanacak kayıt sayısı |
| count (yanıtta) | Filtreye uyan toplam kayıt |
İlk sayfadaki count değeri toplam sayfa sayısını hesaplamanızı sağlar. Sayfa boş ya da limitten kısa döndüğünde durun. Çok büyük kataloglarda offset sınırına takılmamak için durum ya da tarih filtresiyle aralığı daraltın.
Kotayı korumanın yolları
- Değişmeyen veriyi önbelleğe alın; kategori ağacı gibi büyük yanıtlar her istekte gerekmez.
- İlan listesini includes=Images ile okuyun; ilan başına ayrı görsel isteği atmazsınız.
- 429 aldığınızda retry-after kadar bekleyin, ardından üstel geri çekilmeyle tekrar deneyin.
- Sık değişen siparişleri sık, yavaş değişen ilan listesini seyrek okuyun.
- Daha yüksek sınır gerekiyorsa Etsy, uygulama açıklaması ve tahmini kullanımla başvuru yapılmasını ister.
Sık sorulanlar
Etsy API günlük istek sınırı kaç?
Sınır uygulamaya göre değişir ve geliştirici portalında görünür. Yanıtlardaki x-limit-per-day başlığı da sizin günlük sınırınızı gösterir.
Etsy günlük kota gece yarısı sıfırlanır mı?
Hayır. Etsy kayan 24 saatlik pencere kullanır. Eski isteklerin bulunduğu dilim pencereden çıktıkça kota kademeli olarak geri gelir.
Etsy 429 hatası alınca ne yapmalı?
retry-after başlığındaki süre kadar bekleyip isteği tekrarlayın. Tekrarlarda bekleme süresini artırın ki tüm istekler aynı anda yeniden gönderilmesin.
Etsy bir istekte kaç kayıt döndürür?
Varsayılan 25, en fazla 100. Daha fazlası için offset ile sayfa sayfa ilerleyin; offset en fazla 12000 olabilir.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı