Skip to main content
Whop-apps vises i en iframe på whop.com. For at finde ud af, hvem der sender en forespørgsel til din app, sender Whop et kortlivet JSON Web Token (JWT) i x-whop-user-token-headeren på hver forespørgsel fra samme oprindelse. Du verificerer dette token med SDK’et for at få et bruger-ID og kontrollerer derefter, hvad brugeren kan se.

Verificer iframe-brugertokenet

verifyUserToken er ikke tilgængelig i den nuværende @whop/sdk, så TypeScript-eksemplerne på denne side bevares som reference og vil ikke køre, som de står. Python er anderledes: whop-sdk leverer hjælpefunktionen som whop_sdk.lib.verify_user_token, som kræver, at PyJWT er installeret ved siden af (pip install "pyjwt[crypto]"). whop_sdk-gem’en leverer den også, men som en modulfunktion under et andet rod-namespace end klienten: WhopSDK::Helpers::VerifyUserToken.verify_user_token!, hvor klienten er Whop_sdk::Client. Det er ikke en metode på klienten, og gem’en afhænger allerede af jwt.
Kald verifyUserToken på hver forespørgsel. Den læser x-whop-user-token-headeren, validerer JWT-signaturen og udløbstiden og returnerer bruger-ID’et. Ugyldige tokens kaster som standard en fejl. TypeScript og Python tilbyder også en variant, der ikke kaster fejl:
Tokenet vedhæftes kun forespørgsler til din iframes window.location.origin. Eksempler:
  • Relativ sidenavigation: <a href="/da/sub_page">...</a>
  • Fetch-kald uden domæne: await fetch("/api/quizzes")
Disse peger på dit App.base_url-domæne.
Hvis din frontend kører på example.com, men dit API kører på api.example.com, skal du sende API-forespørgsler gennem en reverse proxy via example.com/api, så de bærer x-whop-user-token-headeren.
  • Cloudflare: Opret en “origin rule” fra /api på example.com, der omskriver til api.example.com/api.
  • Next.js: Tilføj en rewrite i next.config.mjs.
  • nginx / Caddy: Brug rewrite-funktionen i din serverkonfiguration.
Denne opsætning er nødvendig på grund af browsernes strenge cookiepolitikker på tværs af oprindelser.

Lokal opsætning

Whop leverer en lokal reverse proxy, der efterligner iframe- og cookieadfærden i produktion, så den kode, du skriver, fungerer ens på localhost og i produktion. Se guiden til udviklingsproxyen for opsætning.

Kontrollér adgang

Nu hvor du ved, hvem der sender forespørgslen, skal du kontrollere, hvad vedkommende må se. Brug metoden checkAccess til at verificere adgang til en Experience, en konto eller et produkt.

Ressource-ID’er og adgangsniveauer

Svarets access_level er en af følgende:

Kundeapp (experience-visning)

Kundeapps bør begrænse adgangen ud fra det experienceId, der sendes i stiparametrene. Returner no_access, eller omdiriger, hvis seeren ikke har et gyldigt medlemskab.
Det samme mønster fungerer i en API-route. Udskift headers() med request.headers, og returner en 403 Response i stedet for JSX.

Dashboard-app (dashboard-visning)

Dashboard-apps bør begrænse adgangen ud fra access_level === "admin", så kun kontoens teammedlemmer kan indlæse visningen.
Samme mønster i en API-route. Udskift headers() med request.headers, og returner en 403 Response i stedet for JSX.

Næste trin

Kør en lokal udviklingsproxy

Efterlign iframe- og cookieopsætningen fra produktion på localhost.

Anmod om tilladelser

Tilføj de scopes, din app har brug for, før du udgiver.

Lyt til webhooks

Modtag hændelser for betalinger, medlemskaber og tilmeldinger på din server.

Byg en app-visning

Opsæt dashboard-visninger, experiences og discover-opslag.