Skip to main content
Les applications Whop s’affichent dans une iframe sur whop.com. Pour savoir qui envoie une requête à votre application, Whop transmet un JSON Web Token (JWT) de courte durée dans l’en-tête x-whop-user-token de chaque requête de même origine. Vous vérifiez ce jeton avec le SDK pour obtenir un ID utilisateur, puis vous contrôlez ce que cet utilisateur peut voir.

Vérifier le jeton utilisateur de l’iframe

verifyUserToken n’est pas disponible dans la version actuelle de @whop/sdk : les extraits TypeScript de cette page sont donc conservés à titre de référence et ne fonctionneront pas en l’état. Python est différent : whop-sdk fournit la fonction utilitaire sous le nom whop_sdk.lib.verify_user_token, qui nécessite l’installation de PyJWT à côté (pip install "pyjwt[crypto]"). La gem whop_sdk la fournit également, mais sous forme de fonction de module dans un espace de noms racine différent de celui du client : WhopSDK::Helpers::VerifyUserToken.verify_user_token!, alors que le client est Whop_sdk::Client. Ce n’est pas une méthode du client, et la gem dépend déjà de jwt.
Appelez verifyUserToken à chaque requête. Cette fonction lit l’en-tête x-whop-user-token, valide la signature et l’expiration du JWT, puis renvoie l’ID utilisateur. Par défaut, les jetons invalides lèvent une exception. TypeScript et Python proposent aussi une variante qui ne lève pas d’exception :
Le jeton n’est joint qu’aux requêtes qui atteignent le window.location.origin de votre iframe. Exemples :
  • Navigation relative entre pages : <a href="/sub_page">...</a>
  • Requêtes fetch sans domaine : await fetch("/api/quizzes")
Elles sont résolues vers le domaine de votre App.base_url.
Si votre frontend s’exécute sur example.com mais votre API sur api.example.com, faites passer les requêtes API par un reverse proxy via example.com/api afin qu’elles portent l’en-tête x-whop-user-token.
  • Cloudflare : créez une « origin rule » de /api sur example.com pour réécrire vers api.example.com/api.
  • Next.js : ajoutez un rewrite dans next.config.mjs.
  • nginx / Caddy : utilisez la primitive de réécriture dans la configuration de votre serveur.
Cette configuration est nécessaire en raison des politiques strictes des navigateurs en matière de cookies cross-origin.

Configuration locale

Whop fournit un reverse proxy local qui reproduit le comportement de l’iframe et des cookies en production, afin que le code que vous écrivez fonctionne de la même manière sur localhost et en production. Consultez le guide du proxy de développement pour la configuration.

Vérifier l’accès

Maintenant que vous savez qui envoie la requête, vérifiez ce que cette personne est autorisée à voir. Utilisez la méthode checkAccess pour vérifier l’accès à une Experience, un Account ou un Product.

ID de ressource et niveaux d’accès

Le champ access_level de la réponse prend l’une des valeurs suivantes :

Application client (vue Experience)

Les applications client doivent contrôler l’accès à partir de l’experienceId transmis dans les paramètres de chemin. Renvoyez no_access ou effectuez une redirection si l’utilisateur ne dispose pas d’une adhésion valide.
Le même modèle fonctionne dans une route API. Remplacez headers() par request.headers et renvoyez une 403 Response au lieu du JSX.

Application Dashboard (vue Dashboard)

Les applications Dashboard doivent contrôler l’accès avec access_level === "admin" afin que seuls les membres de l’équipe du compte puissent charger la vue.
Même modèle dans une route API. Remplacez headers() par request.headers et renvoyez une 403 Response au lieu du JSX.

Étapes suivantes

Exécuter un proxy de développement local

Reproduisez la configuration iframe et cookies de production sur localhost.

Demander des permissions

Ajoutez les scopes dont votre application a besoin avant de la publier.

Écouter les webhooks

Recevez sur votre serveur les événements de paiement, d’adhésion et d’inscription.

Créer une vue d'application

Configurez les vues Dashboard, les expériences et les fiches de découverte.