Adım adım anahtar oluşturma
İşlem birkaç dakika sürer. Başlamadan önce kalıcı bağlantı ayarınızı kontrol edin; REST API varsayılan “Düz” bağlantı yapısıyla çalışmaz.
| Adım | Ekrandaki yer | Not |
|---|---|---|
| 1 | Ayarlar > Kalıcı bağlantılar | “Düz” dışında bir yapı seçili olmalı |
| 2 | WooCommerce > Ayarlar > Gelişmiş > REST API | “Anahtar ekle” düğmesine basın |
| 3 | Açıklama | Anahtarı tanımanızı sağlar, ör. “Pazaryeri entegrasyonu” |
| 4 | Kullanıcı | Anahtar bu kullanıcının yetkileriyle çalışır |
| 5 | İzinler | Okuma, Yazma ya da Okuma/Yazma |
| 6 | API anahtarı oluştur | Consumer Key, Consumer Secret ve QR kod görünür |
WooCommerce 3.4 öncesinde bu ekran WooCommerce > Ayarlar > API > Keys/Apps altındaydı. Eski bir kurulumda menüyü bulamıyorsanız sürümünüzü kontrol edin.
Consumer Key ck_ ile, Consumer Secret cs_ ile başlar. Belgedeki örneklerde de bu biçim görülür: ck_xxxxxxxx ve cs_xxxxxxxx.
Hangi izni seçmelisiniz?
İzin, anahtarı kullanan yazılımın sitenizde ne yapabileceğini belirler. Gereğinden geniş izin vermeyin; ama stok senkronu için hem okuma hem yazma gerekir.
| İzin | Ne sağlar | Uygun kullanım |
|---|---|---|
| Okuma (Read) | Ürün, sipariş ve diğer verileri okur | Raporlama, yalnız sipariş listeleme |
| Yazma (Write) | Kayıt oluşturur ve günceller | Tek başına nadiren yeterli |
| Okuma/Yazma (Read/Write) | İkisini birlikte yapar | Stok, fiyat ve ürün senkronu |
Yalnız Okuma izniyle açılmış bir anahtarla stok yazmaya çalışırsanız istek yetki hatası alır. Bu durumda mevcut anahtarı silip Okuma/Yazma izniyle yenisini üretin.
Anahtar bir WordPress kullanıcısına bağlıdır
WooCommerce belgesine göre anahtarla yapılan her istek, seçilen kullanıcının rol ve yetkilerine uyar. Kullanıcı siparişleri göremiyorsa anahtar da göremez.
- Seçilen kullanıcı silinirse anahtar çalışmayı bırakır.
- Anahtarlar başka bir kullanıcıya devredilmez; yeni kullanıcı için yeni anahtar gerekir.
- Belge, siparişlere erişimi olan bir kullanıcı seçilmesini önerir.
Pratik öneri: anahtarı, çalışan değişikliğinde silinmeyecek bir yönetici hesabına bağlayın. Personel hesabı kapanınca entegrasyonun sessizce durması sık görülen bir sorundur.
Uygulamalar için otomatik anahtar uç noktası
Bir yazılım geliştiriyorsanız kullanıcıdan anahtarı elle kopyalamasını istemek zorunda değilsiniz. WooCommerce, /wc-auth/v1/authorize adresinde bir yetkilendirme uç noktası sunar.
| Parametre | Açıklama |
|---|---|
| app_name | Uygulamanızın adı (zorunlu) |
| scope | read, write ya da read_write (zorunlu) |
| user_id | Kendi sisteminizdeki kullanıcı kimliği; WooCommerce kullanıcı numarası değildir |
| return_url | Onaydan sonra kullanıcının döneceği adres |
| callback_url | Anahtarların JSON olarak gönderileceği adres; HTTPS olmalı |
Kullanıcı onay verince anahtarlar consumer_key, consumer_secret ve key_permissions alanlarıyla callback_url adresine POST edilir. Dönüşte success parametresi 1 ya da 0 olur. Belge bu uç noktanın müşteri girişi için kullanılmaması gerektiğini özellikle belirtir.
Sık yapılan hatalar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Secret görünmüyor | Anahtar ekranından çıkıldı | Yeni anahtar oluşturun |
| Tüm istekler 404 | Kalıcı bağlantılar “Düz” | Başka bir bağlantı yapısı seçin |
| Stok yazılamıyor | Anahtar yalnız Okuma izinli | Okuma/Yazma izinli anahtar üretin |
| Bir gün entegrasyon durdu | Anahtarın kullanıcısı silindi | Kalıcı bir kullanıcıya yeni anahtar bağlayın |
Kullanmadığınız anahtarları aynı ekrandaki iptal bağlantısıyla kaldırın. Anahtar türleri hakkında genel bilgi için pazaryeri API anahtarı nedir yazısına bakabilirsiniz.
Sık sorulanlar
WooCommerce API anahtarı nereden alınır?
WordPress yönetim panelinde WooCommerce > Ayarlar > Gelişmiş > REST API yolunu izleyip “Anahtar ekle” düğmesine basarsınız. Açıklama, kullanıcı ve izin seçtikten sonra Consumer Key ve Consumer Secret görünür.
Consumer Secret kaybolursa ne yapmalıyım?
Secret ikinci kez gösterilmez. Eski anahtarı iptal edip yenisini oluşturun ve bağlı yazılımlardaki değeri güncelleyin.
Stok senkronu için hangi izin gerekir?
Okuma/Yazma. Yazılım hem ürün ve siparişleri okumalı hem de stok adetlerini güncelleyebilmelidir.
Birden fazla yazılım aynı anahtarı kullanabilir mi?
Teknik olarak kullanabilir, ama her yazılıma ayrı anahtar açmak daha güvenlidir. Bir yazılımla çalışmayı bıraktığınızda yalnız onun anahtarını iptal edersiniz.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı