> ## 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.

# Proxy de développement

> Exécutez le proxy de développement Whop pour reproduire l'authentification et le comportement de l'iframe de production pendant le développement.

En production, votre application s'exécute dans l'iframe Whop derrière un reverse proxy qui injecte l'en-tête `x-whop-user-token` dans chaque requête. Chaque application Whop vérifie ce jeton via [`whopsdk.verifyUserToken`](https://docs.whop.com/fr/developer/guides/authentication) : vous avez donc besoin du même en-tête sur `localhost` pour tester avec de vrais utilisateurs. Le proxy de développement l'injecte pour vous.

> [!WARNING]
>
> `verifyUserToken` n'est pas disponible dans la version actuelle de `@whop/sdk`. L'en-tête décrit ici est toujours injecté comme indiqué.

## Choisir votre configuration

Il existe deux modes d'installation. Les deux utilisent le même binaire de proxy. La différence est de savoir si le proxy lance votre serveur de développement ou s'exécute à côté.

| | Encapsulé (Node/JS) | Autonome |
| - | - | - |
| **Idéal pour** | Next.js, Express, tout projet avec un script de développement basé sur Node | Python, Ruby, Go, tout ce qui n'est pas en JS |
| **Fonctionnement** | `whop-proxy --command 'next dev'` lance votre serveur | Votre serveur s'exécute sur un port, et le proxy lui transmet les requêtes |
| **Port** | Un seul port (proxy + serveur) | Deux ports (proxy sur 3000, serveur par exemple sur 5000) |
| **Installation** | `pnpm add -D @whop-apps/dev-proxy` | `pnpm dlx @whop-apps/dev-proxy --standalone` (aucune installation nécessaire) |

## Application `Next.js` et `JavaScript`

**1. Ajouter le proxy comme dépendance de développement**

```bash pnpm theme={null}
pnpm add -D @whop-apps/dev-proxy
```

```bash bun theme={null}
bun install -D @whop-apps/dev-proxy
```

```bash npm theme={null}
npm install -D @whop-apps/dev-proxy
```

```bash yarn theme={null}
yarn add -D @whop-apps/dev-proxy
```

**2. Mettre à jour le script dev dans package.json**

Mettez à jour le script `dev` dans `package.json` pour y inclure le proxy.

```json theme={null}
"scripts": {
    "dev": "whop-proxy --command 'next dev --turbopack'",
}
```

> [!NOTE]
>
> Vous pouvez adapter la commande `dev` aux exigences de votre framework.
> Vous pouvez aussi encapsuler d'autres commandes avec le proxy de la même manière.

**3. Exécuter le proxy**

```bash pnpm theme={null}
pnpm dev
```

```bash npm theme={null}
npm run dev
```

```bash yarn theme={null}
yarn dev
```

## Mode autonome (autres frameworks)

**1. Exécuter votre application en local**

Exécutez votre application sur votre machine locale sur un port de votre choix, par exemple 5000.

```bash Python + FastAPI theme={null}
uvicorn main:app --port 5000
```

```bash Ruby on Rails theme={null}
rails server -p 5000
```

```bash Go theme={null}
go run main.go --port 5000
```

**2. Exécuter le proxy en mode autonome**

```bash pnpm theme={null}
pnpm dlx @whop-apps/dev-proxy --standalone --upstreamPort=5000 --proxyPort=3000
```

```bash bun theme={null}
bunx @whop-apps/dev-proxy --standalone --upstreamPort=5000 --proxyPort=3000
```

```bash npm theme={null}
npx @whop-apps/dev-proxy --standalone --upstreamPort=5000 --proxyPort=3000
```

```bash yarn theme={null}
yarn dlx @whop-apps/dev-proxy --standalone --upstreamPort=5000 --proxyPort=3000
```

> [!NOTE]
>
> Le proxy s'exécute alors comme un processus indépendant. Il démarre un serveur sur
> le port 3000, transmet les requêtes au port 5000 et ajoute le jeton utilisateur dans les
> en-têtes.

## Options de la commande du proxy

Configurez le proxy avec les options de ligne de commande suivantes :

```bash theme={null}
Usage: pnpm dlx @whop-apps/dev-proxy [options]

Options:

--proxyPort <port>      The port the proxy should listen on (3000 by default)
--upstreamPort <port>   The port the upstream server is listening on (set automatically by default)
--npmCommand <command>  The npm command to run to start the upstream server (dev by default)
--command <command>     The command to run to start the upstream server (npm run dev by default)
--standalone            Run the proxy as an independent process proxying requests from one port to another port. Ignores the command / npmCommand options.
```

## Étapes suivantes

> [card] [Authentification](https://docs.whop.com/fr/developer/guides/authentication.md)
>
> Vérifiez le jeton utilisateur de l'iframe avec le même code en local et en production.

> [card] [Écouter les webhooks](https://docs.whop.com/fr/developer/guides/webhooks.md)
>
> Transférez les webhooks Whop vers localhost pendant le développement (utilisez ngrok ou Cloudflare Tunnel).

> [card] [Créer des vues d'application](https://docs.whop.com/fr/developer/guides/app-views.md)
>
> Configurez les points d'entrée iframe dans lesquels votre application s'affichera.

> [card] [Demander des permissions](https://docs.whop.com/fr/developer/guides/permissions.md)
>
> Configurez les scopes dont votre application a besoin avant de la publier.
