Kimlik doğrulama, temel adres ve sürüm
| Konu | Değer |
|---|---|
| Temel adres | https://SITENIZ/wp-json/wc/v3 |
| Güncel sürüm | v3; WooCommerce 3.5 ve WordPress 4.4 ya da üstü |
| Kimlik bilgisi | Consumer Key ve Consumer Secret |
| HTTPS’te doğrulama | Basic Auth; gerekirse sorgu dizesi |
| HTTP’de doğrulama | OAuth 1.0a tek ayaklı imza |
| Ön koşul | Kalıcı bağlantılar “Düz” dışında bir yapı |
Anahtarlar WooCommerce > Ayarlar > Gelişmiş > REST API ekranında üretilir ve seçilen WordPress kullanıcısının yetkileriyle çalışır. Ayrıntılar API anahtarı oluşturma sayfasında.
Sınırlar ve genel hata kodları
| Konu | Değer |
|---|---|
| Sayfa başına kayıt | Varsayılan 10, en fazla 100 |
| Toplam bilgisi | X-WP-Total ve X-WP-TotalPages başlıkları |
| Batch sınırı | Varsayılan 100 nesne |
| İstek hızı | Çekirdek belgede sabit sınır yok; barındırmaya bağlı |
| Hata kodları | 400, 401, 404, 500; gövdede code, message, data.status |
Hataların çözümü hata kodları, sayfalama sayfalama ve sınırlar sayfasında.
WooCommerce API işlemleri
Genel
WooCommerce API anahtarı oluşturma: Consumer Key ve Consumer SecretWordPress panelinde REST API anahtarı üretme adımları, doğru izin seçimi ve anahtarın bağlı olduğu kullanıcıyla ilgili kurallar.WooCommerce REST API kimlik doğrulama: Basic Auth, sorgu dizesi ve OAuth 1.0aConsumer Key ve Consumer Secret ile isteklerin nasıl doğrulandığı; Basic Auth, sorgu dizesi ve OAuth 1.0a arasındaki farklar.WooCommerce REST API v3: sürümler, temel adres ve gereksinimlerHangi WooCommerce sürümünde hangi API sürümünün çalıştığı, temel adres, sunucu gereksinimleri ve yanıt biçimiyle ilgili kurallar.WooCommerce REST API sayfalama ve sınırlar: per_page, X-WP-TotalPages ve batchListelerin nasıl sayfalandığı, toplam sayfa başlıkları, toplu istek sınırı ve istek hızını belirleyen etkenler.WooCommerce REST API hata kodları ve çözümleriHTTP durum kodları, hata gövdesinin yapısı, toplu isteklerdeki kayıt bazlı hatalar ve en sık bağlantı sorunlarının çözümleri.
Ürün ve varyant
WooCommerce ürün listeleme API: GET /products, alanlar ve filtrelerGET /products yanıtındaki stok, fiyat ve kimlik alanları, işe yarayan filtreler ve yalnız değişen ürünleri çekme yöntemi.WooCommerce API ile ürün oluşturma: POST /productsPOST /products gövdesi, alan kuralları, varyasyonlu ürünün iki adımda açılması, görsel yükleme gecikmeleri ve silme davranışı.WooCommerce varyasyon API: varyasyonlu ürünlerde stok ve fiyatVaryasyonların okunması ve güncellenmesi, manage_stock değerinin parent olabilmesi, stok düzeyi seçimi ve kimlik hataları.WooCommerce SKU ve GTIN (global_unique_id): pazaryeri eşleştirmesi için kimlik alanlarıStok kodu ve barkod alanlarının API’deki yeri, bu alanlarla arama ve pazaryeri ürünleriyle eşleştirmede sık yapılan hatalar.
Stok
WooCommerce stok güncelleme API: stock_quantity ve manage_stockTek ürün ve varyasyon stoğunu yazma, stok alanlarının anlamı, mutlak değer yazmanın riski ve geçici sıfır stok sorunu.WooCommerce toplu güncelleme API: /products/batch ve /variations/batchBatch isteğinin gövde yapısı, 100 nesne sınırı, varyasyonlar için ayrı adres ve yanıtın kayıt kayıt kontrol edilmesi.WooCommerce stok yönetimi: envanter ayarları, stok tutma ve siparişlerin stoğa etkisiMağaza genelindeki envanter ayarları, siparişin hangi durumda stoğu düşüp geri eklediği ve pazaryeriyle birlikte kullanırken dikkat edilecekler.
Sipariş
WooCommerce sipariş API: GET /orders, tarih filtreleri ve sipariş alanlarıGET /orders filtreleri, sipariş ve kalem alanları, değişen siparişleri yakalama ve Türkiye adreslerinde il alanının biçimi.WooCommerce sipariş durumları API: pending, processing, on-hold, completed ve diğerleriAPI’deki sekiz durum değeri, her birinin ödeme ve stok anlamı, durumu API ile değiştirme ve pazaryeri senkronunda eşleme.WooCommerce iade ve iptal API: /orders/ID/refunds, api_refund ve api_restockİade oluşturma ve listeleme uç noktaları, para ve stok iadesini yöneten alanlar, sunucu hesaplı iade ve iptalle iade arasındaki fark.
Webhook
WooCommerce webhook kurulumu: konu, teslim adresi ve gizli anahtarWebhook’un panelden ve API’den oluşturulması, çekirdek konular, teslim davranışı, art arda hatalarda devre dışı kalma ve kayıtların okunması.WooCommerce webhook imza doğrulama: X-WC-Webhook-Signature ve başlıklarTeslimat başlıkları, imzanın ham gövde üzerinden doğrulanması, gövdenin içeriği ve kaçırılan bildirimlere karşı önlemler.
Sık sorulanlar
WooCommerce REST API ücretsiz mi?
Evet. REST API WooCommerce çekirdeğinin parçasıdır; ayrı bir eklenti ya da ücret gerekmez. Anahtarı kendi WordPress panelinizden üretirsiniz.
WooCommerce stoğunu pazaryerleriyle API üzerinden nasıl eşitlerim?
Siparişleri ve ürünleri düzenli okuyup stok değişikliklerini /products/batch ya da /variations/batch ile yazan bir entegrasyon kurarsınız. Webhook’lar değişiklikleri beklemeden haber verir. Hazır çözüm için WooCommerce entegrasyonu sayfasına bakabilirsiniz.
WooCommerce API anahtarı nerede oluşturulur?
WooCommerce > Ayarlar > Gelişmiş > REST API ekranında “Anahtar ekle” ile. Stok yazmak için Okuma/Yazma izni seçilir.
Varyasyonların stoğu nasıl güncellenir?
Varyasyonlar ana ürünün /products/ANA_URUN/variations adresinden yönetilir; toplu güncelleme için variations/batch kullanılır.