API anahtarı

API anahtarı nedir?

API anahtarı; WP Entegrasyon'un sizi tanıyabilmesi için her istekte gönderilmesi gereken gizli bir karakter dizisidir. wpe_ ön ekiyle başlar ve oluşturulduktan sonra yalnızca bir kez görüntülenir; sonrasında panelde yalnızca son birkaç karakteri (önizleme) görebilirsiniz.

Yeni anahtar oluşturma

1. WP Entegrasyon paneline giriş yapın ve API Anahtarları ekranına gidin.
2. Yeni anahtar oluştur butonuna basın, bir isim girin (örnek: WooCommerce mağazası — production).
3. Yetki kapsamlarını seçin. Her kapsam, anahtarın hangi uçlara erişebileceğini belirler:
   • shipments:write — yeni gönderi oluşturma, iptal etme.
   • shipments:read — gönderi durumu sorgulama.
   • sms:send — SMS bildirim tetikleme.
4. Oluştur'a bastığınızda anahtar tek seferlik olarak gösterilir. Güvenli bir parola yöneticisinde saklayın.

Anahtarınızı kaybederseniz geri alma seçeneği yoktur. Bu durumda mevcut anahtarı iptal edip yenisini oluşturmanız gerekir.

Eklentiye bağlama

WordPress yöneticisinde WP Entegrasyon → Ayarlar sayfasına gidip API Anahtarı alanına oluşturduğunuz anahtarı yapıştırın. Eklenti, anahtarın geçerliliğini sunucumuzda /v1/health uç noktasıyla doğrular.

Doğrudan API kullanımı

Kendi entegrasyonunuzu yazıyorsanız her isteğe aşağıdaki başlığı ekleyin:

Authorization: Bearer wpe_xxxxxxxxxxxxxxxxxxxxxxxx

Anahtar döndürme

Düzenli güvenlik pratiği olarak en az 6 ayda bir anahtarınızı döndürmenizi öneririz. Yeni anahtarı oluşturup eklenti ayarlarına kaydettikten sonra eski anahtarı panelden iptal edebilirsiniz.

Anahtar sızıntısı şüphesi

Anahtarınızın sızdırıldığını düşünüyorsanız hemen panelden İptal et butonuna basın. İptal edilen anahtarla yapılan istekler 401 hatası alır.