Skip to main content
Whop’un beş kimlik bilgisi türü vardır. Hangisine ihtiyacınız olduğu, kimin verisine eriştiğinize ve kodun nerede çalıştığına bağlıdır. Bu tablodan seçin, ardından kimlik bilgisi üretime yaklaşmadan önce kapsamını daraltın.

API anahtarları

Bir Account API anahtarı, sunucunuzun kimliğini tek bir hesap olarak doğrular. Bir App API anahtarı ise uygulamanızın kimliğini, onu kuran tüm hesaplarda doğrular. Her ikisi de gizlidir: bunları sunucu tarafında tutun.

Bir Account API anahtarı oluşturun

Sunucunuz kendi hesabınız ve onun alt hesapları adına işlem yaptığında bir Account API anahtarı kullanın. Kontrol panelinin Developer sayfasında Account API Keys bölümünü açın ve Create seçeneğini seçin. Hızlı başlangıç bunu sandbox’ta adım adım anlatır.

Bir App API anahtarı oluşturun

Bir uygulama oluşturduğunuzda ve onu kuran hesaplardaki verilere erişmeniz gerektiğinde bir App API anahtarı kullanın.
  1. Kontrol panelinde Apps bölümünü açın.
  2. Create app seçeneğini seçin ve uygulamanıza bir ad verin. Adı daha sonra değiştirebilirsiniz.
  3. Anahtarınız, Environment variables bölümünde WHOP_API_KEY ifadesinden sonraki gizli değerdir. Göstermek için gösterme düğmesini kullanın, ardından güvenli bir yerde saklayın.

Hesap kapsamlı kullanıcı token’ları

Hesap kapsamlı bir kullanıcı token’ı, belirli bir hesap içindeki belirli bir kullanıcı olarak işlem yapar. Sunucunuz bunu API anahtarınızla oluşturur ve istemcinize iletir; böylece kullanıcılarınız Whop’ta hiç oturum açmadan Whop’a erişir. account_id, user_id ve izin vermek istediğiniz işlemleri ileterek POST /api/v1/access_tokens ile bir tane oluşturun:
account_id, biz_ ile ve user_id, user_ ile başlar. API anahtarınızın her ikisine de erişim izni olmalıdır. Token’ların süresi varsayılan olarak bir saat içinde dolar. Bunu değiştirmek için expires_at değerini en fazla üç saate kadar ayarlayın. Token’ları önbelleğe almak yerine ihtiyaç duyulduğunda oluşturun.

Bir token’ın kapsamını belirleme

scoped_actions, token’ın yapabileceği şeylerin listesidir. Her giriş, iki nokta üst üste ile ayrılmış bir işlem dizesidir.
scoped_actions değerini boş bırakırsanız veya hiç belirtmezseniz, token onu oluşturan kimlik bilgisinin sahip olduğu tüm izinleri devralır. Bu durumda bir tarayıcıya verilen token, API anahtarınızın tüm erişimini taşır. Her zaman açık bir liste iletin.
Bir işlem, token’ı oluşturan kimlik bilgisinin kendi izinlerinin bir alt kümesi olmalıdır. API anahtarınızın sahip olmadığı bir izni veremezsiniz. Bu işlemler bugün Whop’un kılavuzlarında yer almaktadır: API sabit bir liste yayınlamaz, bu nedenle bunu eksiksiz liste olarak değil, belgelenmiş küme olarak değerlendirin. Kesin sınır her zaman token’ı oluşturan kimlik bilgisinin kendi izinleridir.

Hesap erişim token’ları

Bir hesap erişim token’ı, herhangi bir kullanıcıya bağlı olmadan hesabın kendisi olarak işlem yapar. Yalnızca account_id ve izin verilecek scoped_actions değerlerini ileterek POST /api/v1/access_tokens ile bir tane oluşturun. Süresi, hesap kapsamlı bir kullanıcı token’ıyla aynı takvime göre dolar. Bir istemcinin, örneğin gömülü bir bileşenin, kısa bir süre için hesabınızın erişimine ihtiyaç duyduğu ve belirli bir kullanıcının söz konusu olmadığı durumlarda kullanın. Bildirim veya tercih uç noktaları gibi kullanıcı olarak işlem yapan uç noktalar bunu reddeder.

iframe kullanıcı token’ları

Uygulamanız Whop içinde görüntülendiğinde, aynı kaynaktan gelen her istek x-whop-user-token başlığında kısa ömürlü bir JWT taşır. Kimin istekte bulunduğunu öğrenmek için imzasını doğrularsınız, ardından neyi görebileceklerini kontrol edersiniz. Python ve Ruby SDK’ları bunun için bir yardımcı içerir. TypeScript SDK’sı içermez, bu nedenle JWT’yi kendiniz doğrulayın. Bunu asla siz oluşturmazsınız. Whop gönderir, siz doğrularsınız. Bkz. Kimlik doğrulama.

OAuth token’ları

Bir OAuth token’ı, Whop’ta oturum açmış ve uygulamanızı bir dizi kapsam için onaylamış bir kullanıcıyı temsil eder. Bir API anahtarının aksine, erişimi o kullanıcının yapabilecekleriyle sınırlıdır. Bunu Whop ile Oturum Açma için ve bir kullanıcının kendi hesabı üzerinde onun adına işlem yapmak için kullanın. Bkz. OAuth.

Kapsam belirleme kontrol listesi

Bir kimlik bilgisi üretime ulaşmadan önce:
  • Oluşturulan her token’da açık scoped_actions iletin. Asla devralmaya güvenmeyin.
  • Hangi uç noktaları çağırdığınızı öğrendikten sonra API anahtarlarını Admin’de bırakmak yerine onlara özel bir izin kümesi verin.
  • API anahtarlarını sunucu tarafında tutun. İstemcide yalnızca kullanıcı token’ları bulunmalıdır.
  • Uzun ömürlü token’ları önbelleğe almak yerine ihtiyaç duyulduğunda kısa ömürlü token’lar oluşturun.
  • Her ortam için ayrı kimlik bilgileri kullanın ve para hareketi yaratan herhangi bir şeyi çalıştırmadan önce hangisini kullandığınızı kontrol edin.

Sonraki adımlar

Hızlı başlangıç

Bir sandbox anahtarı oluşturun ve ilk çağrınızı yapın.

Temel Kavramlar

Hesapların, kullanıcıların ve izinlerin birbiriyle ilişkisi.

OAuth

Eksiksiz OAuth 2.1 ve PKCE akışı.

Sandbox'ta test edin

Kimlik bilgilerini önce test verileri üzerinde deneyin.