Gövde yapısı
Batch isteği üç listeyi aynı anda taşıyabilir. Yalnız ihtiyacınız olan listeyi göndermeniz yeterlidir.
| Liste | İçerik | Örnek kullanım |
|---|---|---|
| create | Yeni ürün nesneleri | Toplu ürün açma |
| update | id alanı olan nesneler | Stok ve fiyat güncelleme |
| delete | Silinecek numaralar | Toplu silme |
Belgeye göre bu üç listedeki nesnelerin toplamı varsayılan olarak 100’ü geçmemelidir. Aynı yapı siparişler için /orders/batch ve webhook’lar için /webhooks/batch adresinde de vardır.
Örnek: 3 ürünün stoğu
Numaralar ve adetler sahtedir.
- Adres: POST /wp-json/wc/v3/products/batch
- update öğesi 1: id 101, stock_quantity 5
- update öğesi 2: id 102, stock_quantity 0
- update öğesi 3: id 103, stock_quantity 12
Aynı ana ürüne ait varyasyonlar için adres değişir: POST /wp-json/wc/v3/products/200/variations/batch. Farklı ana ürünlerin varyasyonları tek istekte birleştirilemez; her ana ürün için ayrı batch isteği gerekir.
Yanıtı kayıt kayıt okuyun
Batch yanıtı istekteki listelerin karşılığını döndürür: update listesinde her öğe ya güncellenmiş ürün ya da hata bilgisi taşır. İstek bütün olarak 200 dönse bile bazı kayıtlar reddedilmiş olabilir.
| Yanıttaki öğe | Anlamı | Ne yapmalı |
|---|---|---|
| Ürün nesnesi | Kayıt güncellendi | Yeni değeri kaydedin |
| id ve error nesnesi | Kayıt reddedildi | Mesajı okuyun, kaydı düzeltip yeniden gönderin |
| İstek 400 ya da 401 | Bütün istek reddedildi | Gövdeyi ve anahtarı kontrol edin |
En sık görülen kayıt hatası, varyasyon numarasının /products/batch’e gönderilmesidir. Bu durumda kayıt geçersiz kimlik hatası alır. Hata ayrıntıları hata kodları sayfasında.
Batch mi, tek istek mi?
| Durum | Öneri |
|---|---|
| 1-2 ürün | Tek PUT isteği yeterli |
| Onlarca ürün | Batch, 100’lük parçalar |
| Farklı ana ürünlerin varyasyonları | Her ana ürün için ayrı variations/batch |
| Görselli toplu ürün açma | Küçük parçalar; görsel indirme isteği uzatır |
Belge 100 sınırını “varsayılan olarak” diye anar. Siteniz farklı bir değer kullanıyor olabilir; ama genel bir entegrasyonda 100’ü güvenli üst sınır kabul edin. Parçalar arasında sunucunun yanıt vermesini bekleyin; aynı anda çok sayıda batch göndermek paylaşımlı barındırmada zaman aşımına yol açabilir.
Yeniden deneme ve tutarlılık
Batch isteği ağ hatası ya da zaman aşımıyla yarıda kalabilir. Bu durumda sunucu kayıtların bir kısmını işlemiş olabilir. Stok gibi kesin değer yazan güncellemelerde aynı isteği yeniden göndermek genellikle güvenlidir, çünkü aynı adet ikinci kez yazılır.
- create listesini yeniden göndermeden önce ürünlerin oluşup oluşmadığını SKU ile kontrol edin; aksi hâlde çift ürün açılabilir.
- Yeniden denemeler arasında bekleme süresini her seferinde artırın.
- Başarısız kalan kayıtları ayrı bir listede toplayın ve kullanıcıya gösterin; sessizce atlamayın.
- Büyük güncellemeden önce birkaç ürünlük küçük bir batch ile deneme yapın.
Sık sorulanlar
WooCommerce’te toplu stok güncelleme nasıl yapılır?
POST /wp-json/wc/v3/products/batch isteğinde update listesine id ve stock_quantity alanlarıyla ürünleri yazarsınız. Varsayılan sınır 100 nesnedir.
Varyasyonları ürün batch adresine gönderebilir miyim?
Hayır. Varyasyonlar ana ürünün /products/ANA_URUN/variations/batch adresine gönderilir.
Batch yanıtı 200 ama bazı ürünler değişmedi, neden?
Batch yanıtında her kaydın kendi sonucu vardır. Reddedilen kayıtlar error bilgisiyle döner; listeyi tek tek kontrol edin.
Batch ile ürün silebilir miyim?
Evet, delete listesine numaraları yazarsınız. Silme davranışı için ürün silme kurallarını kontrol edin.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı