API anahtarları

Mağaza API’sine yapılan her istek bir API anahtarı taşır. Anahtar Petanque AI’a isteği hangi şirketin gönderdiğini söyler; isteğin hangi ürünlere, müşterilere ve siparişlere ulaşabileceği buna göre belirlenir.

Anahtarın biçimi

psk_<keyId>.<secret>

Anahtarı x-storefront-token başlığında gönderin:

GET /api/website/products HTTP/1.1
Host: api.petanqueai.com
x-storefront-token: psk_...

Anahtarı sunucunuzda tutun

Bir anahtar şirketiniz adına sipariş oluşturabilir ve ödemeleri okuyabilir. Onu asla tarayıcı JavaScript’ine, bir mobil uygulama paketine ya da herkese açık bir repoya koymayın. API’yi sunucunuzdan çağırın ve tarayıcıya yalnızca sonucu iletin.

Anahtar oluşturma

1. Petanque AI’da Ayarlar → Web Sitesi sayfasını açın. Bunun için web sitesi yönetimi yetkisine sahip olmanız gerekir.
2. Yeni anahtar oluştur’u seçin.
3. Anahtara bir ad verin (1 ile 80 karakter arası), örneğin canlı web sitesi. İsterseniz bir son kullanma tarihi de ekleyin.
4. Anahtarı kopyalayın. Anahtar yalnızca bir kez gösterilir. Petanque AI anahtarın kendisini değil, yalnızca parmak izini saklar. Kaybolan bir anahtar tekrar gösterilemez, yerine yenisini oluşturun.

Bir şirket aynı anda en fazla 10 aktif anahtar tutabilir. İptal edilmiş ve süresi dolmuş anahtarlar bu sayıya dahil değildir.

Anahtarı yenileme

Kesinti yaşamadan anahtar değiştirmek için ikinci bir anahtar kullanın:

1. Yeni bir anahtar oluşturun.
2. Sitenizi yeni anahtarla yayınlayın.
3. Eski anahtarı, onu kullanan trafik kalmadığında iptal edin.

Anahtarı iptal etme

Bir anahtarı kullanmayı bıraktığınızda ya da sızdığından şüphelendiğinizde aynı ekrandan hemen iptal edin. İptal edilmiş bir anahtarla gelen istekler anında reddedilir.

Anahtar reddedildiğinde

Eksik, hatalı biçimli, iptal edilmiş ya da süresi dolmuş bir anahtara HTTP 401 ile yanıt verilir. Başlık adının x-storefront-token olduğunu, anahtarın tamamının kopyalandığını ve anahtarın Ayarlar → Web Sitesi’nde hâlâ aktif olduğunu kontrol edin.