SÖZLÜKOtomasyon ve entegrasyon

API anahtarı nedir?

Kısa tanım

API anahtarı, bir yazılımın başka bir sistemin API'sine erişirken kimliğini ve yetkisini kanıtlamak için kullandığı gizli, uzun bir karakter dizisidir. Şifre gibi saklanır, yalnızca gereken izinlerle oluşturulur ve iş bitince iptal edilir.

Son güncelleme:

API anahtarı nedir, şifreden farkı ne?

API anahtarı nedir sorusunun kısa yanıtı: bir programın, sizin adınıza mağazanızın verisine ulaşmasını sağlayan gizli koddur. Şifreyi bir insan yazar; API anahtarını bir yazılım her istekte kendiliğinden gönderir. Anahtar, kişinin şifresinden ayrı üretilir; yalnızca belirli bir işe izin verebilir ve o iş bitince şifreye dokunmadan iptal edilebilir. Bu yüzden kargo, pazaryeri ya da bildirim entegrasyonuna yönetici şifreniz değil, o iş için üretilmiş bir anahtar verilir.

WooCommerce API anahtarı nasıl oluşturulur?

WooCommerce API anahtarı, WooCommerce › Ayarlar › Gelişmiş › REST API ekranında "Anahtar ekle" ile oluşturulur. WooCommerce REST API belgesine (yeni sekmede açılır) göre anahtar bir WordPress kullanıcısına bağlanır ve o kullanıcının yetkileri kadar iş yapabilir; izin olarak okuma, yazma ya da okuma/yazma seçilir. Ekran, tüketici anahtarı (consumer key) ve tüketici gizli anahtarını (consumer secret) yalnızca bir kez gösterir; ikisi de kaydedilmeden kapatılırsa yeni anahtar üretmek gerekir.

WooCommerce API anahtarı izin düzeyleri
İzin Ne yapabilir Hangi entegrasyona yeter
Okuma Sipariş, ürün ve müşteri bilgisini okur Bildirim, rapor, muhasebe aktarımı
Yazma Kayıt oluşturur ve değiştirir, okuyamaz Nadiren tek başına kullanılır
Okuma/yazma Okur ve değiştirir Stok ve fiyat eşitleme, sipariş durumu güncelleme

WordPress'in kendi REST API'si için ayrı bir yol vardır: WordPress belgesine (yeni sekmede açılır) göre 5.6 sürümünden beri kullanıcı profilinden "uygulama şifresi" üretilir ve yalnızca HTTPS üzerinden kullanılır.

API anahtarı nasıl güvende tutulur?

API anahtarı, yönetici şifreniz gibi korunur. Her entegrasyona ayrı anahtar verin ve açıklama alanına hangi iş için olduğunu yazın; böylece biri sızarsa yalnızca onu iptal edersiniz. İzni işin gerektirdiği kadar tutun: yalnızca okuyan bir entegrasyona okuma/yazma anahtarı vermeyin. Anahtarı e-posta ya da WhatsApp ile göndermeyin; karşı tarafın panelindeki ilgili alana doğrudan yazın. Entegrasyon bittiğinde ya da anahtarı bilen bir çalışan ayrıldığında anahtarı silip yenisini üretin.

E-ticarette örnek

WhatsApp Sipariş Bildirimi modülü mesajdaki adı, sipariş numarasını ve tutarı siparişin kendisinden okur; bunun için yalnızca okuma izinli bir WooCommerce API anahtarı yeterlidir. Aynı kurulumda Meta tarafı için kalıcı bir erişim anahtarı üretilir; geçici anahtar 24 saatte geçersiz olduğu için kullanılmaz. Her iki anahtar da Sedeus panelindeki ayar alanına yazılır ve kaydedildikten sonra panelde gösterilmez. Adımların tamamı WhatsApp Sipariş Bildirimi kurulum rehberinde anlatılır. Anahtar erişim için yeterli, güvenlik için tek başına yetersizdir: bağlantı HTTPS ile şifrelenmeli, anahtar şifre gibi saklanmalıdır.

Nerede karşınıza çıkar?

  • WooCommerce › Ayarlar › Gelişmiş › REST API ekranındaki tüketici anahtarı ve gizli anahtarı
  • WordPress kullanıcı profilindeki uygulama şifreleri
  • Meta WhatsApp Cloud API için üretilen kalıcı erişim anahtarı
  • Pazaryeri satıcı panelindeki API bilgileri
  • Kargo ve e-fatura entegrasyonlarının API kullanıcı bilgileri
  • Sedeus panelinde entegrasyon ayarlarına yazılan anahtar alanları

Adım adım örnek

WooCommerce'te yalnızca okuma izinli API anahtarının nasıl oluşturulup panele yazıldığını kurulum rehberinde anlattık.

API anahtarı hakkında sık sorulanlar

API anahtarım sızdıysa ne yapmalıyım?
Anahtarı üretildiği ekrandan hemen silin ya da iptal edin; WooCommerce'te REST API listesinden kaldırmak yeterlidir. Sonra yeni bir anahtar üretip entegrasyonun ayarına yazın. Anahtar okuma/yazma izinliyse son günlerdeki sipariş, ürün ve fiyat değişikliklerini gözden geçirin.
Her entegrasyon için ayrı API anahtarı gerekir mi?
Gerekir. Tek anahtarı üç sisteme verirseniz biri sızdığında üçünü de durdurmak zorunda kalırsınız. Ayrı anahtar, ayrı açıklama ve işe uygun izin; hangi sistemin ne yaptığını da panelden görmenizi sağlar.
API anahtarı ile erişim belirteci (token) aynı şey mi?
Aynı işi görürler, biçimleri farklıdır. API anahtarı çoğunlukla sabit bir koddur; erişim belirteci (access token) bir oturum için üretilir ve süresi dolabilir. Meta'nın geçici belirteci 24 saatte geçersiz olur, kalıcı belirteç süresizdir. Hangisini kullanacağınızı karşı sistemin belgesi söyler.
ÜCRETSİZ, 1 İŞ GÜNÜ

İlk adımı birlikte atalım

Operasyonunuzdaki elle yürüyen işleri inceleyip ayda kaç saatin sistemle yürüyebileceğini yazılı olarak veriyoruz; teknik bilgi ve taahhüt gerekmez.

  • Kredi kartı yok
  • 1 iş gününde dönüş
  • KVKK uyumlu
  • Veriler şifreli bağlantıyla iletilir