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
KaldverifyUserToken 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:
window.location.origin. Eksempler:
- Relativ sidenavigation:
<a href="/da/sub_page">...</a> - Fetch-kald uden domæne:
await fetch("/api/quizzes")
App.base_url-domæne.
API'et ligger på et andet domæne
API'et ligger på et andet 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
/apipåexample.com, der omskriver tilapi.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 metodencheckAccess 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 detexperienceId, der sendes i stiparametrene. Returner no_access, eller omdiriger, hvis seeren ikke har et gyldigt medlemskab.
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 fraaccess_level === "admin", så kun kontoens teammedlemmer kan indlæse visningen.
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.

