Sürüm tablosu
WooCommerce, WordPress REST API ile bütünleşik çalışır. Sürüm numarası adresin içinde yer alır.
| API sürümü | WooCommerce | WordPress | Durum |
|---|---|---|---|
| v3 | 3.5 ve üstü | 4.4 ve üstü | Güncel, yeni işler için önerilen |
| v2 | 3.0 ve üstü | 4.4 ve üstü | Eski |
| v1 | 2.6 ve üstü | 4.4 ve üstü | Eski |
| Legacy REST API | Çekirdekten kaldırıldı | - | Yalnız ayrı eklentiyle |
Legacy REST API’ye bağlı eski bir entegrasyon kullanıyorsanız WordPress.org’daki WooCommerce Legacy REST API eklentisini kurmanız gerekir. Belgeye göre Legacy API’yi kullanan webhook’lar da bu eklenti olmadan çalışmaz. Belgelerin yeni adrese taşınmasıyla ilgili özet bu yazıda.
Temel adres ve yanıt biçimi
Tüm v3 uç noktaları şu kalıbı izler: https://SITENIZ/wp-json/wc/v3/KAYNAK. Örneğin sipariş listesi /wp-json/wc/v3/orders adresindedir.
- Varsayılan yanıt biçimi JSON’dur; başarılı istek 200 OK döner.
- Tarihler ISO 8601 biçimindedir: YYYY-AA-GGTSS:DD:SS.
- Kaynak kimlikleri tam sayıdır.
- Fiyat ve toplam gibi para tutarları iki ondalıklı metin olarak gelir, ör. “21.99”.
- Adet gibi diğer sayılar tam sayıdır.
- Boş alanlar çoğunlukla atlanmaz; null ya da boş metin olarak gelir.
Para tutarlarının metin olması önemlidir. Fiyatı sayıya çevirmeden toplama yaparsanız metin birleştirme hatası alırsınız.
Sunucu gereksinimleri
| Gereksinim | Neden |
|---|---|
| Kalıcı bağlantılar “Düz” olmamalı | Varsayılan bağlantı yapısında /wp-json adresleri çalışmaz |
| HTTPS önerilir | Basic Auth yalnız HTTPS’te güvenlidir |
| WP REST API eklentisi gerekmez | Destek WordPress çekirdeğinde |
| PUT ve DELETE açık olmalı | Kapalıysa _method özelliğiyle gönderilebilir |
Belge, ModSecurity kullanan sunucularda 501 Method Not Implemented hatası görülebileceğini not eder. Yerel bilgisayarda SSL hatası alıyorsanız test aracında SSL doğrulamasını kapatmanız önerilir; canlı sitede ise geçerli bir sertifika kullanın. WooPayments etkinse /wp-json/wc/v3/payments/ altında ek uç noktalar oluşur. Bu uç noktalardaki bazı tutarlar, çekirdeğin ondalıklı metinlerinden farklı olarak en küçük para birimiyle tam sayı döner.
Stok ve sipariş için önemli v3 kaynakları
| Kaynak | Adres | İşe yarar |
|---|---|---|
| Ürünler | /products | Basit ve ana ürün listesi, stok, fiyat |
| Varyasyonlar | /products/ID/variations | Beden, renk gibi seçeneklerin stok ve fiyatı |
| Kategoriler | /products/categories | Kategori ağacı |
| Siparişler | /orders | Sipariş listesi ve durumları |
| Sipariş iadeleri | /orders/ID/refunds | İade oluşturma ve listeleme |
| Tüm iadeler | /refunds | Siparişten bağımsız salt okunur iade listesi |
| Webhook’lar | /webhooks | Olay aboneliklerini yönetme |
Her kaynağın ayrıntısı bu rehberin ilgili sayfasında. Örneğin stok için stok güncelleme, siparişler için sipariş listeleme sayfasına bakın.
Sık sorulanlar
WooCommerce REST API v3 hangi sürümle çalışır?
Belgeye göre v3 için WooCommerce 3.5 ve WordPress 4.4 ya da üstü gerekir.
Legacy REST API hâlâ kullanılabilir mi?
Çekirdekten kaldırıldı. Eski bir entegrasyon buna ihtiyaç duyuyorsa WooCommerce Legacy REST API eklentisi kurulup Gelişmiş > Legacy API altında etkinleştirilmelidir.
Neden /wp-json adresleri 404 veriyor?
En yaygın neden kalıcı bağlantı ayarının “Düz” olmasıdır. Ayarlar > Kalıcı bağlantılar altında başka bir yapı seçin.
API dizinine erişmek için anahtar gerekir mi?
Belgeye göre API dizini, yani /wp-json/wc/v3 adresi, kimlik doğrulama olmadan açılır. Kaynaklara erişmek için anahtar gerekir.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı