Basit ürün için örnek gövde
Aşağıdaki değerler sahtedir. Gövde JSON olarak gönderilir; Content-Type başlığı application/json olmalıdır.
- name: Örnek Ürün
- type: simple
- status: draft
- sku: SAHTE-SKU-001
- regular_price: 199.90 (metin olarak)
- sale_price: 179.90 (isteğe bağlı)
- manage_stock: true
- stock_quantity: 12
- categories: id değeri 15 olan bir kategori
- images: src değeri herkese açık bir görsel adresi olan bir öğe
Önce draft ile oluşturup kontrol ettikten sonra yayına almak, yanlış fiyatla satışa açılma riskini azaltır.
Alanların kuralları
| Alan | Kural |
|---|---|
| type | simple, grouped, external ya da variable; varsayılan simple |
| status | draft, pending, private ya da publish; varsayılan publish |
| regular_price, sale_price | Metin; ör. “199.90” |
| manage_stock | Varsayılan false; adet tutmak için true gönderin |
| categories | Öğede yazılabilir alan id’dir; name ve slug salt okunur |
| images | id ile ortam kitaplığındaki görsel ya da src ile yeni görsel adresi |
| brands | Yazarken id alanı olan marka nesneleri |
| sku | Benzersiz tanımlayıcı |
manage_stock varsayılan olarak false’tur. Göndermezseniz stock_quantity değeriniz adet olarak işlenmez. Pazaryeriyle senkron edilecek her üründe stok yönetimini açın.
Varyasyonlu ürün iki adımda açılır
Belgedeki örnekte önce type=variable olan ana ürün, seçenekleriyle birlikte oluşturulur. Seçenekler attributes dizisinde verilir: variation=true olan özellik varyasyonda kullanılır, options değerleri listeler.
| Adım | İstek | İçerik |
|---|---|---|
| 1 | POST /products | type=variable, attributes, default_attributes |
| 2 | POST /products/ID/variations | Her seçenek birleşimi için fiyat, SKU, stok |
| 2 (toplu) | POST /products/ID/variations/batch | En fazla 100 varyasyon tek istekte |
Ana ürün oluşturulduğunda varyasyonlar kendiliğinden oluşmaz. Her varyasyonu açıkça eklemeniz gerekir. Ayrıntılar varyasyonlar sayfasında.
Görseller ve zaman aşımı
src ile verilen görseller site tarafından indirilip ortam kitaplığına eklenir. Görsel büyük ya da sayıca fazlaysa istek uzun sürer. İstemciniz zaman aşımına düşse bile ürün sitede oluşmuş olabilir.
- Tekrar denemeden önce aynı SKU ile ürün olup olmadığını GET /products?sku=... ile kontrol edin.
- Görsel adreslerinin herkese açık ve doğrudan dosyaya giden adresler olduğundan emin olun.
- Mevcut bir ürünü kopyalamak için POST /products/ID/duplicate uç noktası vardır.
Silme ve çöp kutusu
DELETE /products/ID isteğinde force parametresi varsayılan olarak false’tur; ürün çöp kutusuna taşınır ve panelden geri alınabilir. force=true ürünü kalıcı siler. Varyasyonlar ise çöp kutusunu desteklemez; varyasyon silmek için force=true zorunludur.
Sık sorulanlar
WooCommerce API ile ürün eklemek için hangi alanlar gerekir?
Pratikte ad, fiyat ve stok bilgisi yeterlidir. Tür belirtilmezse simple, durum belirtilmezse publish kabul edilir.
Görsel nasıl eklenir?
images dizisine src alanıyla herkese açık görsel adresini yazarsınız. Ortam kitaplığındaki bir görsel için id kullanılır.
Varyasyonlu ürünü tek istekte açabilir miyim?
Belgedeki akışta hayır. Önce variable türünde ana ürün açılır, sonra varyasyonlar /products/ID/variations ya da batch adresiyle eklenir.
Ürünü API ile silersem geri alabilir miyim?
force=false ile silinen ürün çöp kutusuna gider ve geri alınabilir. force=true kalıcıdır.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı