> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Authentification et clés API

> Les cinq types d'identifiants Whop, quand utiliser chacun d'eux et comment restreindre un identifiant aux seules actions dont il a réellement besoin.

Whop propose cinq types d'identifiants. Celui dont vous avez besoin dépend des données auxquelles vous accédez et de l'endroit où s'exécute le code. Choisissez dans ce tableau, puis restreignez l'identifiant avant qu'il n'approche la production.

| Identifiant | Agit en tant que | Emplacement | À utiliser lorsque |
| - | - | - | - |
| **Clé API** | Votre compte, ou votre application | Votre serveur | Votre backend accède à votre propre compte, ou à chaque compte ayant installé votre application |
| **Jeton utilisateur limité à un compte** | Un utilisateur, au sein d'un compte | Généré sur votre serveur, utilisé dans votre client | Votre produit a déjà ses propres utilisateurs et vous souhaitez qu'ils accèdent à Whop sans connexion Whop |
| **Jeton d'accès au compte** | Votre compte, avec des permissions restreintes | Généré sur votre serveur, utilisé dans votre client | Un client a besoin d'un accès de courte durée à votre compte sans détenir votre clé API |
| **Jeton utilisateur iframe** | L'utilisateur qui consulte votre application | Envoyé par Whop, vérifié par vous | Votre application s'affiche dans Whop et vous devez savoir qui la consulte |
| **Jeton OAuth** | Un utilisateur connecté à Whop | Votre serveur, après le flux OAuth | Vous voulez que les utilisateurs se connectent avec Whop et accordent à votre application l'accès à leur compte |

## Clés API

Une clé API de compte authentifie votre serveur en tant que compte. Une clé API d'application authentifie votre application sur chaque compte qui l'a installée. Les deux sont des secrets : conservez-les côté serveur.

### Créer une clé API de compte

Utilisez une clé API de compte lorsque votre serveur agit pour votre propre compte et ses [sous-comptes](https://docs.whop.com/fr/developer/platforms/enroll-subaccounts.md). Dans la page Developer du tableau de bord, ouvrez **Account API Keys** et sélectionnez **Create**. Le [démarrage rapide](https://docs.whop.com/fr/developer/quickstart.md) décrit la procédure dans le sandbox.

### Créer une clé API d'application

Utilisez une clé API d'application lorsque vous créez une application et devez accéder aux données des comptes qui l'ont installée.

1. Dans le tableau de bord, ouvrez **Apps**.
2. Sélectionnez **Create app** et donnez un nom à votre application. Vous pourrez le modifier plus tard.
3. Votre clé est la valeur masquée après `WHOP_API_KEY` dans la section **Environment variables**. Utilisez le bouton d'affichage pour la révéler, puis conservez-la en lieu sûr.

## Jetons utilisateur limités à un compte

Un jeton utilisateur limité à un compte agit en tant qu'utilisateur précis au sein d'un compte précis. Votre serveur le génère avec votre clé API et le transmet à votre client, afin que vos utilisateurs accèdent à Whop sans jamais se connecter à Whop.

Créez-en un avec `POST /api/v1/access_tokens`, en transmettant `account_id`, `user_id` et les actions que vous souhaitez autoriser :

```bash theme={null}
curl https://api.whop.com/api/v1/access_tokens \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_XXXXXXXX",
    "user_id": "user_XXXXXXXX",
    "scoped_actions": ["chat:read", "chat:message:create"]
  }'
```

`account_id` commence par `biz_` et `user_id` commence par `user_`. Votre clé API doit être autorisée à accéder aux deux.

Les jetons expirent par défaut au bout d'**une heure**. Définissez `expires_at` pour modifier cette durée, dans la limite de **trois heures**. Générez-les à la demande plutôt que de les mettre en cache.

> [!NOTE]
>
> Consultez [Créer un jeton d'accès](https://docs.whop.com/fr/api-reference/legacy/access-tokens/create-access-token.md).

### Restreindre un jeton

`scoped_actions` est la liste des opérations autorisées pour le jeton. Chaque entrée est une chaîne d'action dont les parties sont séparées par des deux-points.

> [!WARNING]
>
> Si vous laissez `scoped_actions` vide ou l'omettez, le jeton **hérite de toutes les permissions de l'identifiant qui l'a généré**. Un jeton transmis à un navigateur dispose alors de toute la portée de votre clé API. Transmettez toujours une liste explicite.

Une action doit faire partie des permissions de l'identifiant qui génère le jeton. Vous ne pouvez pas accorder ce que votre clé API ne possède pas.

Ces actions apparaissent aujourd'hui dans les guides Whop :

| Action | Autorise |
| - | - |
| `chat:read` | Lire les canaux et les messages de chat |
| `chat:message:create` | Envoyer des messages de chat |
| `dms:read` | Lire les messages privés |
| `dms:message:manage` | Envoyer et gérer des messages privés |
| `dms:channel:manage` | Créer et gérer des canaux de messages privés |
| `support_chat:read` | Lire les chats d'assistance |
| `support_chat:message:create` | Envoyer des messages dans les chats d'assistance |
| `company:balance:read` | Lire le solde d'un compte |

L'API ne publie pas de liste fixe : considérez donc cette liste comme l'ensemble documenté plutôt que comme l'ensemble complet. La limite qui fait foi reste toujours les permissions de l'identifiant qui génère le jeton.

## Jetons d'accès au compte

Un jeton d'accès au compte agit en tant que compte lui-même, sans utilisateur associé. Créez-en un avec `POST /api/v1/access_tokens`, en transmettant uniquement `account_id` et les `scoped_actions` à autoriser. Il expire selon le même calendrier qu'un jeton utilisateur limité à un compte.

Utilisez-le lorsqu'un client a besoin de l'accès de votre compte pendant une courte durée, par exemple pour un composant intégré, sans qu'aucun utilisateur précis ne soit impliqué. Les endpoints qui agissent en tant qu'utilisateur, comme ceux des notifications ou des préférences, le refusent.

## Jetons utilisateur `iframe`

Lorsque votre application s'affiche dans Whop, chaque requête de même origine contient un JWT de courte durée dans l'en-tête `x-whop-user-token`. Vous vérifiez sa signature pour savoir qui fait la demande, puis vous contrôlez ce que cette personne peut voir. Les SDK Python et Ruby fournissent une fonction utilitaire pour cela. Ce n'est pas le cas du SDK TypeScript : vérifiez donc le JWT vous-même.

Vous ne générez jamais ce jeton. Whop l'envoie, et vous le validez. Consultez [Authentification](https://docs.whop.com/fr/developer/guides/authentication.md).

## Jetons OAuth

Un jeton OAuth représente un utilisateur qui s'est connecté à Whop et a approuvé votre application pour un ensemble de scopes. Contrairement à une clé API, sa portée est limitée à ce que cet utilisateur peut faire.

Utilisez-le pour Sign in with Whop et pour agir au nom d'un utilisateur sur son propre compte. Consultez [OAuth](https://docs.whop.com/fr/developer/guides/oauth.md).

## Liste de contrôle des restrictions

Avant qu'un identifiant n'atteigne la production :

* Transmettez des `scoped_actions` explicites pour chaque jeton généré. Ne comptez jamais sur l'héritage.
* Attribuez aux clés API un ensemble de permissions personnalisé dès que vous savez quels endpoints vous appelez, plutôt que de les laisser en Admin.
* Conservez les clés API côté serveur. Seuls les jetons utilisateur ont leur place dans un client.
* Générez des jetons de courte durée à la demande au lieu de mettre en cache des jetons de longue durée.
* Utilisez des identifiants distincts pour chaque environnement, et vérifiez celui que vous utilisez avant d'exécuter toute opération qui déplace de l'argent.

## Étapes suivantes

> [card] [Démarrage rapide](https://docs.whop.com/fr/developer/quickstart.md)
>
> Créez une clé sandbox et effectuez votre premier appel.

> [card] [Concepts clés](https://docs.whop.com/fr/developer/concepts.md)
>
> Comment les comptes, les utilisateurs et les permissions sont liés.

> [card] [OAuth](https://docs.whop.com/fr/developer/guides/oauth.md)
>
> Le flux complet OAuth 2.1 et PKCE.

> [card] [Tester dans le sandbox](https://docs.whop.com/fr/developer/guides/sandbox.md)
>
> Essayez d'abord vos identifiants sur des données de test.


## Related topics

- [Authentification du chat](https://docs.whop.com/fr/developer/guides/chat/authentication.md)
- [Concepts clés de l'API Whop](https://docs.whop.com/fr/developer/concepts.md)
- [Démarrage rapide de l'API Whop](https://docs.whop.com/fr/developer/quickstart.md)
