Skip to main content
Whop-apps worden weergegeven in een iframe op whop.com. Om te bepalen wie een request naar je app doet, geeft Whop bij elk same-origin-request een kortlevende JSON Web Token (JWT) mee in de header x-whop-user-token. Je verifieert dit token met de SDK om een gebruikers-ID te krijgen en controleert daarna wat die gebruiker mag zien.

Het iframe-gebruikerstoken verifiëren

verifyUserToken is niet beschikbaar in de huidige @whop/sdk, dus de TypeScript-fragmenten op deze pagina zijn ter referentie bewaard en werken niet zoals ze er staan. Bij Python ligt dat anders: whop-sdk levert de helper als whop_sdk.lib.verify_user_token, waarvoor PyJWT ernaast geïnstalleerd moet zijn (pip install "pyjwt[crypto]"). De whop_sdk-gem levert hem ook, maar als modulefunctie onder een andere root-namespace dan de client: WhopSDK::Helpers::VerifyUserToken.verify_user_token!, terwijl de client Whop_sdk::Client is. Het is geen methode van de client, en de gem is al afhankelijk van jwt.
Roep verifyUserToken bij elk request aan. De functie leest de header x-whop-user-token, valideert de handtekening en vervaldatum van de JWT en retourneert de gebruikers-ID. Ongeldige tokens geven standaard een fout. TypeScript en Python bieden ook een variant die geen fout gooit:
Het token wordt alleen meegestuurd met requests naar de window.location.origin van je iframe. Voorbeelden:
  • Relatieve paginanavigatie: <a href="/nl/sub_page">...</a>
  • Fetches zonder domein: await fetch("/api/quizzes")
Deze worden herleid naar je App.base_url-domein.
Als je frontend op example.com draait maar je API op api.example.com, stuur API-requests dan via een reverse proxy door example.com/api, zodat ze de header x-whop-user-token bevatten.
  • Cloudflare: maak een “origin rule” die /api op example.com herschrijft naar api.example.com/api.
  • Next.js: voeg een rewrite toe in next.config.mjs.
  • nginx / Caddy: gebruik de rewrite-functie in je serverconfiguratie.
Deze setup is nodig vanwege het strikte cross-origin-cookiebeleid van browsers.

Lokale setup

Whop levert een lokale reverse proxy die het iframe- en cookiegedrag van productie nabootst, zodat de code die je schrijft precies hetzelfde werkt op localhost als in productie. Zie de gids voor de development proxy voor de setup.

Toegang controleren

Nu je weet wie het request doet, controleer je wat die persoon mag zien. Gebruik de methode checkAccess om de toegang tot een Experience, Account of Product te verifiëren.

Resource-ID’s en toegangsniveaus

De access_level in de response is een van de volgende:

Klantapp (experience-weergave)

Klantapps moeten de toegang afschermen op basis van de experienceId die in de padparameters wordt meegegeven. Retourneer no_access of stuur door als de bezoeker geen geldig lidmaatschap heeft.
Hetzelfde patroon werkt in een API-route. Vervang headers() door request.headers en retourneer een 403 Response in plaats van JSX.

Dashboardapp (dashboardweergave)

Dashboardapps moeten de toegang afschermen op access_level === "admin", zodat alleen teamleden van het account de weergave kunnen laden.
Hetzelfde patroon in een API-route. Vervang headers() door request.headers en retourneer een 403 Response in plaats van JSX.

Volgende stappen

Een lokale development proxy draaien

Boots de iframe- en cookiesetup van productie na op localhost.

Permissies aanvragen

Voeg de scopes toe die je app nodig heeft voordat je publiceert.

Naar webhooks luisteren

Ontvang events voor betalingen, lidmaatschappen en entries op je server.

Een app-weergave bouwen

Stel dashboardweergaven, experiences en Discover-vermeldingen in.