Skip to main content
Whop uygulamaları 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

verifyUserToken güncel @whop/sdk içinde mevcut değildir, bu nedenle bu sayfadaki TypeScript kod parçacıkları referans amacıyla tutulmaktadır ve yazıldıkları şekliyle çalışmaz. Python farklıdır: whop-sdk, yardımcıyı whop_sdk.lib.verify_user_token olarak sunar ve bunun yanında PyJWT’nin kurulu olmasını gerektirir (pip install "pyjwt[crypto]"). whop_sdk gem’i de bunu sunar, ancak istemciden farklı bir kök ad alanı altında bir modül fonksiyonu olarak: WhopSDK::Helpers::VerifyUserToken.verify_user_token!; istemci ise Whop_sdk::Client’tır. Bu, istemci üzerinde bir yöntem değildir ve gem zaten jwt’ye bağımlıdır.
Her istekte verifyUserToken ç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:
Token yalnızca iframe’inizin 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")
Bunlar App.base_url alan adınıza çözümlenir.
Ö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 /api yolunu api.example.com/api olarak yeniden yazmak için bir “origin rule” oluşturun.
  • Next.js: next.config.mjs iç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 kod localhost ü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çin checkAccess 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 iletilen experienceId 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.
Aynı kalıp bir API rotasında da çalışır. 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çin access_level === "admin" koşuluna göre erişimi kısıtlamalıdır.
Bir API rotasında da aynı kalıp geçerlidir. 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.