Kimlik doğrulama

Her istek bir API anahtarı içermelidir. Her API biraz farklı header setleri kabul eder.

API Store
User API
qPapel Protection

Gizli anahtarınızı (psa_...) Bearer token olarak veya X-API-Key header’ında gönderin.

# Önerilen
Authorization: Bearer psa_your_api_key

# Alternatif
X-API-Key: psa_your_api_key

Her istekte API anahtarınızı ve store hash değerinizi gönderin.

x-api-key: your_api_key
x-store-hash: your_store_hash

Header	Açıklama
`x-api-key`	Panel ayarlarındaki kişisel API anahtarınız.
`x-store-hash`	Mağazanızın benzersiz tanımlayıcısı.

Geliştirici anahtarınızı (pk_live_...) üç yoldan biriyle gönderin.

# Önerilen
Authorization: Bearer pk_live_your_key

# Alternatif
x-api-key: pk_live_your_key

# Eski yöntem (eski loader'lar için desteklenir)
api-key: pk_live_your_key

Bilgilerinizi test edin

Anahtarınızın ve store hash değerinizin çalıştığını doğrulamak için User API’de GET /me çağırın:

curl https://app.papelship.com/api/v1/me \
  -H "x-api-key: your_api_key" \
  -H "x-store-hash: your_store_hash"

Geçerli bir istek mağazayı, anahtarın izinlerini ve limitlerinizi döndürür. Geçersiz bir anahtar INVALID_API_KEY koduyla 401 döndürür.

Anahtarlarınızı güvende tutun

Anahtarları yalnızca sunucuda kullanın

API anahtarları mağazanıza ve lisanslarınıza tam erişim sağlar. Asla frontend JavaScript’e, mobil uygulamalara veya dağıtılan masaüstü binary’lerine gömmeyin.

Anahtarları ortam değişkenlerinde saklayın

Anahtarları ortam değişkenlerinden veya bir secret manager’dan yükleyin. Asla kaynak koda commit etmeyin.

Sızan anahtarı hemen yenileyin

Bir anahtar açığa çıkarsa panelden iptal edin ve yenisini oluşturun.

Başlarken

Temel kavramlar

Bilgilerinizi test edin

Anahtarlarınızı güvende tutun

​Bilgilerinizi test edin

​Anahtarlarınızı güvende tutun

Bilgilerinizi test edin

Anahtarlarınızı güvende tutun