Gömülü sohbet kullanıcılarının kimliğini Whop OAuth ve SDK tarafından yönetilen oturum açma ile doğrulayın.
OAuth ile kullanıcılar Whop’ta bir oturum açma sayfası veya bir iOS webview aracılığıyla kendileri oturum açar. Uygulamanız, gömülü sohbette kimlik doğrulayabilen ve oturum açmış kullanıcı adına işlem yapabilen Whop kullanıcı token’ları alır.Uygulamanızın kullanıcının Whop hesabına erişmesi gerektiğinde veya kendi arka ucunuzdan hesap kapsamlı kullanıcı token’ları oluşturmak istemediğinizde OAuth kullanın.
Eksiksiz OAuth kılavuzu
Eksiksiz OAuth 2.1 + PKCE akışı, token değişimi, yenileme ve iptal ayrıntıları için genel OAuth kılavuzuna bakın.
Kurulum
Güncel @whop/sdk içinde apps.create tarafından döndürülen App nesnesi bir client_secret alanı sunmaz. Bunun yerine istemci gizli anahtarını Kontrol paneli sekmesinden kopyalayın.
API
Kontrol paneli
Programatik olarak bir OAuth uygulaması oluşturmak için Create App uç noktasını kullanın:
Yönlendirme URI’lerini daha sonra Update App uç noktasıyla güncelleyin.
1
Uygulamanızı oluşturun veya seçin
Bir uygulama kimliği almak için uygulamanızı Whop Kontrol Paneli > Developer bölümünde kaydedin.
2
Bir yönlendirme URL'si ekleyin
Oluşturduğunuz uygulamada OAuth bölümünü açın ve bir yönlendirme URL’si ekleyin.
React veya vanilla JavaScript uygulamaları için uygulamanızın geri çağırma URL’sini kullanın, örneğin https://yourapp.com/oauth/callback.
Swift uygulamaları için com.yourapp.bundle://oauth/callback gibi bundle kimliğinizi kullanın veya özel bir yönlendirme URI’si yapılandırın.
3
Kapsamları seçin
Aynı sayfada, gerekli kapsamları View available scopes bölümünden kopyalayın.
Gerekli kapsamlar
OAuth yapılandırmanız şu kapsamları içermelidir:
Kapsam
Amaç
openid, profile, email
Temel profil bilgileri
chat:message:create, chat:read
Kanallar
dms:read, dms:message:manage, dms:channel:manage
Doğrudan mesajlar
support_chat:read, support_chat:message:create
Destek sohbetleri
Web token uç noktası
Sunucunuzun, gerekli kapsamlara sahip geçerli bir OAuth token’ı döndüren bir token uç noktası sağlaması gerekir. React ve vanilla JavaScript sohbet öğeleri, kimlik doğrulamaya ihtiyaç duyduklarında bu fonksiyonu çağırır.
async function getToken() { const response = await fetch("/api/token"); const data = await response.json(); return data.token;}
Sunucu tarafı token değişimini uygulamak için OAuth kılavuzuna bakın.
iOS’ta yazılım geliştirme kiti tarafından yönetilen OAuth
Uygulama başlatıldığında configureWithOAuth çağırın. SDK tüm akışı yönetir: bir oturum açma webview’i gösterir, token’ları alır ve onları otomatik olarak yeniler.
Yönlendirme URI’sinin Whop Kontrol Paneli > Developer > App > OAuth bölümünde yapılandırdığınız değerle eşleştiğinden emin olun.Bir kullanıcı bir sohbet görünümüne gittiğinde, henüz kimliği doğrulanmamışsa SDK OAuth akışını otomatik olarak başlatır. Oturum açma ve oturum kapatma işlemlerini manuel olarak da tetikleyebilirsiniz:
Kullanıcının oturum açıp açmadığını reaktif olarak izlemek için .whopAuthState değiştiricisini kullanın:
struct ChatView: View { @State private var isAuthenticated = false var body: some View { VStack { if isAuthenticated { Text("Signed In") } else { Text("Not Signed In") } } .whopAuthState($isAuthenticated) }}
Token’ları önceden doldurma
Kullanıcının Whop token’larına başka bir kaynaktan zaten sahipseniz, ilk başlatmada oturum açma webview’ini atlamak için bunları önceden doldurabilirsiniz. Kaynaklar arasında bir web OAuth akışı veya arka ucunuzdan senkronize edilen token’lar bulunur. Bu isteğe bağlıdır ve yalnızca kullanıcılarınızın kimliği başka bir yerde Whop ile zaten doğrulanmışsa geçerlidir.
SDK, token’ın son kullanma tarihini JSON Web Token’dan (JWT) çıkarır ve yenilemeyi otomatik olarak yönetir. SDK, süresi dolmuş önceden doldurulmuş token’ları yenileyemezse normal OAuth akışı başlar.
Sonraki adımlar
Kimlik doğrulama
Gömülü sohbet için OAuth’u hesap kapsamlı token’larla karşılaştırın.
Genel OAuth kılavuzu
Eksiksiz OAuth akışını, token değişimini, yenilemeyi ve iptali uygulayın.
Chat öğesi
Sohbet arayüzünün prop’larını, olaylarını, stillerini ve derin bağlantı seçeneklerini öğrenin.
Gömülü sohbet hızlı başlangıcı
İlk gömülü sohbet deneyiminizi görüntüleyin.
Assistant
Responses are generated using AI and may contain mistakes.