Sayfalama parametreleri
Birden çok kayıt dönen her istek sayfalanır. Bütün ürünleri ya da son 30 günün siparişlerini çekmek için sayfaları sırayla gezmeniz gerekir.
| Parametre | Varsayılan | Açıklama |
|---|---|---|
| per_page | 10 | Sayfa başına kayıt; WordPress’te 1 ile 100 arası |
| page | 1 | Sayfa numarası, 1’den başlar |
| offset | - | İlk kayıttan itibaren atlanacak kayıt sayısı |
Varsayılan 10 değerini site yöneticisi posts_per_page seçeneğiyle değiştirebilir. WordPress REST API el kitabına göre per_page en fazla 100’dür. Daha fazlası gerekiyorsa birden çok istek yapıp sonuçları birleştirirsiniz.
Toplam ve bağlantı başlıkları
Yanıtın gövdesinde yalnız o sayfanın kayıtları vardır. Toplam bilgisi başlıklarda gelir.
| Başlık | İçerik |
|---|---|
| X-WP-Total | Toplam kayıt sayısı |
| X-WP-TotalPages | Toplam sayfa sayısı |
| Link: rel=“next” | Sonraki sayfanın adresi |
| Link: rel=“prev” | Önceki sayfanın adresi |
| Link: rel=“first” ve rel=“last” | İlk ve son sayfanın adresi |
Belge, adresleri kendiniz kurmak yerine Link başlığındaki değerleri izlemenizi önerir. Uygulamada bazı barındırma ve vekil sunucu yapılandırmaları X-WP-TotalPages başlığını siler. Başlık yoksa “dolu gelen sayfa, devamı olabilir” kuralıyla bir sonraki sayfayı da isteyin; boş ya da eksik sayfa geldiğinde durun.
Toplu istekler: 100 nesne sınırı
Ürünler, varyasyonlar, siparişler ve webhook’lar için batch uç noktası vardır. Tek istekte oluşturma, güncelleme ve silme listeleri gönderilebilir.
| Batch adresi | Sınır |
|---|---|
| /products/batch | Varsayılan 100 nesne |
| /products/ID/variations/batch | Varsayılan 100 nesne |
| /orders/batch | Varsayılan 100 nesne |
| /webhooks/batch | Varsayılan 100 nesne |
Belgede bu sınır “varsayılan olarak” ifadesiyle verilir. 100’den fazla ürünü güncellemek için listeyi 100’lük parçalara bölün. Ayrıntılar toplu güncelleme sayfasında.
İstek hızı neye bağlı?
WooCommerce’in giriş, kimlik doğrulama ve v3 başvuru belgelerinde çekirdek REST API için sabit bir istek sınırı yer almıyor. Pratikte hız, sitenizin barındırması, güvenlik eklentileri ve önündeki CDN ya da güvenlik duvarı tarafından belirlenir.
- Aynı anda çok sayıda istek göndermek yerine istekleri sıraya koyun.
- Sunucu hata ya da zaman aşımı verirse artan bekleme süreleriyle yeniden deneyin.
- Güvenlik eklentisi REST isteklerini engelliyorsa entegrasyonun IP adresine ya da kullanıcısına izin tanımlayın.
- Görselli ürün oluşturma gibi ağır istekler için zaman aşımını uzun tutun.
Önbellek eklentileri de sorun yaratabilir. REST yanıtı önbelleğe alınırsa aynı adres saatlerce eski değeri döndürebilir. Taze veri gereken okumalarda adrese benzersiz bir sorgu parametresi eklemek bu önbelleği atlatır; Saystok’un canlı gözlemine göre WooCommerce tanımadığı parametreyi yok sayar.
Sık sorulanlar
WooCommerce API’de per_page en fazla kaç olabilir?
WordPress REST API el kitabına göre 100. Daha fazla kayıt için page parametresiyle sonraki sayfaları istersiniz.
Toplam sayfa sayısını nereden öğrenirim?
Yanıtın X-WP-TotalPages başlığından. Toplam kayıt sayısı X-WP-Total başlığında gelir.
WooCommerce REST API’nin istek sınırı var mı?
Okuduğumuz resmî belgelerde çekirdek REST API için sabit bir sınır yayımlanmıyor. Sınırı çoğunlukla barındırma, güvenlik eklentisi ya da CDN belirler; güncel durumu kendi sunucunuzda kontrol edin.
Batch istekte kaç ürün gönderebilirim?
Belgeye göre varsayılan olarak en fazla 100 nesne. Daha fazlası için listeyi 100’lük parçalara bölün.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı