Skip to main content
Whop iki eski API’yi kullanımdan kaldırıyor. Her ikisi de aynı API anahtarlarıyla https://api.whop.com/api/v1 adresindeki Current API’ye taşınıyor.

Current API’ye geçin

1

API anahtarınızı koruyun

Current API aynı hesap ve uygulama API anahtarlarını kullanır. Bir istek 403 döndürürse, anahtarda o uç noktanın ihtiyaç duyduğu izin eksiktir. Bunu Developer → API keys bölümünden ekleyin veya uygulamanızın izinlerinde talep edin.
2

SDK'yı kurun ve bir sürüme sabitleyin

Resmi SDK’lar Current API’yi çağırır ve oluşturuldukları API sürümünü gönderir. @whop/api kullanıyorsanız, onu @whop/sdk ile değiştirin. Onun withUser ve withCompany yardımcılarının bir karşılığı yoktur: bunun yerine kullanıcı veya hesap kimliğini her istekte geçirin.
API’yi bir SDK olmadan çağırıyorsanız, her istekte Api-Version-Date gönderin. API sürümleri sabitlemeyi açıklar.
3

Her çağrıyı değiştirin

Bıraktığınız API’nin sekmesini kullanın, ardından eski temel URL’yi veya paketi kodunuzdan kaldırın.

v2 çağrılarınızı bulun

Her v2 yanıtı üç başlık taşır:Entegrasyonunuzun hâlâ yaptığı her v2 çağrısını bulmak için Deprecation içeren yanıtları günlüğe kaydedin.

Rota haritası

Üyelikler ve lisanslar

Üyeler ve müşteriler

Ödemeler ve ödeme sayfası

Ürünler ve planlar

Planlar artık varyant olarak adlandırılıyor. Varyant kimlikleri plan_ önekini korur, bu nedenle saklanan kimlikler çalışmaya devam eder.

Hesap, deneyimler, yorumlar ve webhook’lar

v2’den bu yana neler değişti

Kısmi güncellemeler

v2, bir kaynağı POST /resource/{id} ile güncelliyordu. Current API PATCH /resource/{id} kullanır ve yalnızca gönderdiğiniz alanları değiştirir.

Lisans anahtarları

v2 validate_license, bir anahtarı kontrol edip tek bir çağrıda bir makineye bağlıyordu. Current API’de sunucunuz üyeliği lisans anahtarıyla alır, status değerini kontrol eder ve biri anahtarı ilk kez kullandığında metadata içine bir donanım kimliği yazar. SaaS kılavuzu tam örneği içerir.Bu çağrıları sunucunuzda tutun. Hesap API anahtarınız işletmenizdeki her üyeliği değiştirebilir, bu nedenle onu asla indirilebilir bir yazılımın içinde dağıtmayın.

v2 biçimindeki webhook’lar

v2 üzerinden oluşturulan webhook’lar v2 biçimindeki yükleri göndermeye devam eder. Güncel biçimi almak için kontrol panelinden veya POST /webhooks ile yeni bir webhook oluşturun, işleyicinizi ona taşıyın, ardından v2 webhook’unu silin. Webhook’lar imza kontrollerini ve olay türlerini ele alır.

Sayfalama

v2, page ve per ile sayfalama yapıyor ve pagination.current_page ile pagination.total_page döndürüyordu. Current API listeleri bir data dizisi ve bir page_info nesnesi döndürür. Sayfa boyutunu ayarlamak için first, sonraki sayfayı almak için önceki page_info.end_cursor değeriyle after geçirin. page_info.has_next_page değeri false olduğunda durun. SDK’lar sayfalamayı sizin yerinize yapar.

Sonraki adımlar

API sürümleri

Sonraki değişikliklerin entegrasyonunuzu asla bozmaması için bir sürüme sabitleyin.

Webhook'lar

İmzaları doğrulayın, güncel olay biçimini işleyin ve yoklama yapmak yerine sohbet mesajlarını alın.

Üyelikleri yönetin

Üyelikleri iptal edin, duraklatın, uzatın ve güncelleyin.

Uygulama görünümleri

Deneyim ve kontrol paneli görünümlerinde üye erişimini kontrol edin.