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.- Kontrol panelinde Apps bölümünü açın.
- Create app seçeneğini seçin ve uygulamanıza bir ad verin. Adı daha sonra değiştirebilirsiniz.
- Anahtarınız, Environment variables bölümünde
WHOP_API_KEYifadesinden 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.
Bkz. Erişim token’ı oluşturma.
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.
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ızcaaccount_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_actionsiletin. 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.

