whop.com üzerinde bir iframe içinde görüntülenir. Uygulamanıza kimin istek yaptığını anlayabilmeniz için Whop, aynı kaynaktan gelen her istekte x-whop-user-token başlığında kısa ömürlü bir JSON Web Token (JWT) iletir. Bir kullanıcı kimliği almak için bu token’ı SDK ile doğrularsınız, ardından o kullanıcının neleri görebileceğini kontrol edersiniz.
iframe kullanıcı token’ını doğrulayın
Her istekteverifyUserToken çağırın. x-whop-user-token başlığını okur, JWT imzasını ve son kullanma tarihini doğrular ve kullanıcı kimliğini döndürür. Geçersiz token’lar varsayılan olarak hata fırlatır. TypeScript ve Python ayrıca hata fırlatmayan bir varyant da sunar:
window.location.origin adresine giden isteklere eklenir. Örnekler:
- Göreli sayfa gezinmesi:
<a href="/sub_page">...</a> - Alan adı içermeyen fetch çağrıları:
await fetch("/api/quizzes")
App.base_url alan adınıza çözümlenir.
API farklı bir alan adında
API farklı bir alan adında
Ön ucunuz
example.com üzerinde, API’niz ise api.example.com üzerinde çalışıyorsa, API isteklerinin x-whop-user-token başlığını taşıması için onları example.com/api üzerinden ters proxy ile yönlendirin.- Cloudflare:
example.comüzerindeki/apiyolunuapi.example.com/apiolarak yeniden yazmak için bir “origin rule” oluşturun. - Next.js:
next.config.mjsiçine bir rewrite ekleyin. - nginx / Caddy: sunucu yapılandırmanızdaki rewrite özelliğini kullanın.
Bu kurulum, tarayıcıların katı çapraz kaynak çerez politikaları nedeniyle gereklidir.
Yerel kurulum
Whop, üretimdeki iframe ve çerez davranışıyla eşleşen yerel bir ters proxy sunar; böylece yazdığınız kodlocalhost üzerinde ve üretimde aynı şekilde çalışır. Kurulum için geliştirme proxy’si kılavuzuna bakın.
Erişimi kontrol edin
Artık isteği kimin yaptığını bildiğinize göre, neyi görmeye yetkili olduklarını kontrol edin. Bir Experience, Account veya Product’a erişimi doğrulamak içincheckAccess yöntemini kullanın.
Kaynak kimlikleri ve erişim düzeyleri
Yanıttaki
access_level şunlardan biridir:
Müşteri uygulaması (deneyim görünümü)
Müşteri uygulamaları, yol parametrelerinde iletilenexperienceId değerine göre erişimi kısıtlamalıdır. Görüntüleyenin geçerli bir üyeliği yoksa no_access döndürün veya yönlendirin.
headers() yerine request.headers kullanın ve JSX yerine bir 403 Response döndürün.
Kontrol paneli uygulaması (kontrol paneli görünümü)
Kontrol paneli uygulamaları, görünümü yalnızca hesabın ekip üyelerinin yükleyebilmesi içinaccess_level === "admin" koşuluna göre erişimi kısıtlamalıdır.
headers() yerine request.headers kullanın ve JSX yerine bir 403 Response döndürün.
Sonraki adımlar
Yerel bir geliştirme proxy'si çalıştırın
Üretimdeki iframe + çerez kurulumunu localhost üzerinde eşleyin.
İzin isteyin
Yayınlamadan önce uygulamanızın ihtiyaç duyduğu kapsamları ekleyin.
Webhook'ları dinleyin
Sunucunuzda ödeme, üyelik ve giriş olaylarını alın.
Bir uygulama görünümü oluşturun
Kontrol paneli görünümlerini, deneyimleri ve keşfet listelemelerini ayarlayın.

