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

# Application

> Une application est une intégration construite sur Whop. Les applications peuvent servir les consommateurs sous forme d'expériences au sein de produits, ou servir les entreprises en tant qu'outils professionnels.

> [!NOTE]
>
> Cette ressource a un successeur dans l'[API actuelle](https://docs.whop.com/fr/api-reference/legacy/apps/app.md), l'API versionnée sur laquelle les nouvelles intégrations doivent s'appuyer. Cette page reste entièrement prise en charge.

```json Example theme={null}
{
	"api_key": {
		"created_at": "2023-12-01T05:00:00.401Z",
		"id": "<string>",
		"token": "<string>"
	},
	"app_type": "b2b_app",
	"base_url": "https://myapp.example.com",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Pickaxe"
	},
	"creator": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	},
	"dashboard_path": "/experiences/[experienceId]",
	"default_api_key": {
		"id": "<string>",
		"name": "<string>",
		"obfuscated_secret_key": "<string>",
		"secret_key": "<string>"
	},
	"description": "A comprehensive analytics dashboard for tracking revenue, members, and growth metrics.",
	"discover_path": "/experiences/[experienceId]",
	"domain_id": "ab1c2d3e4f5g6h7i8j9k",
	"experience_path": "/experiences/[experienceId]",
	"hosted_url": "https://myapp.whop.site",
	"icon": {
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"id": "app_xxxxxxxxxxxxxx",
	"marketplace_status": "not_available",
	"name": "Courses",
	"oauth_client_type": "public",
	"openapi_path": "/experiences/[experienceId]",
	"origin": "<string>",
	"product_id": "<string>",
	"production_web_build": {
		"checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
		"file_url": "https://cdn.whop.com/builds/abc123.zip",
		"id": "apbu_xxxxxxxxxxxxx",
		"source_url": "https://cdn.whop.com/builds/abc123-source.zip",
		"status": "draft"
	},
	"redirect_uris": ["<string>"],
	"requested_permissions": [
		{
			"is_required": true,
			"justification": "<string>",
			"permission_action": {
				"action": "<string>",
				"name": "<string>"
			}
		}
	],
	"route": "myapp",
	"secrets": {},
	"skills_path": "/experiences/[experienceId]",
	"stats": {
		"dau": 42,
		"mau": 42,
		"time_spent_last24_hours": 42,
		"wau": 42
	},
	"status": "live",
	"verified": true
}
```

**api\_key** `object | null` *required*

La clé API utilisée pour authentifier les requêtes au nom de cette application. Null si aucune clé API n'a été générée. Nécessite l'autorisation 'developer:manage\_api\_key'.

**attributs enfants**

**created\_at** `string\<date-time\>` *required*

La date et l'heure de création de la clé API privée.

Exemple : `2023-12-01T05:00:00.401Z`

**id** `string` *required*

L'identifiant unique de la clé API privée.

**token** `string` *required*

Il s'agit de la clé API utilisée pour authentifier les requêtes

**app\_type** `AppTypes` *required*

La classification du public cible de cette application (par ex. 'b2b\_app', 'b2c\_app', 'company\_app', 'component').

Options disponibles : `b2b_app`, `b2c_app`, `company_app`, `component`, `website`

**base\_url** `string | null` *required*

L'URL de base de production où l'application est hébergée. `null` si aucune URL de base n'est configurée, ou si l'appelant ne dispose pas de l'autorisation `developer:basic:read` sur le compte de l'application.

Exemple : `https://myapp.example.com`

**company** `object` *required*

L'entreprise qui possède et publie cette application.

**attributs enfants**

**id** `string` *required*

L'identifiant unique de l'entreprise.

Exemple : `biz_xxxxxxxxxxxxxx`

**title** `string` *required*

Le nom d'affichage de l'entreprise présenté aux clients.

Exemple : `Pickaxe`

**creator** `object` *required*

L'utilisateur qui a créé et possède l'entreprise ayant publié cette application.

**attributs enfants**

**id** `string` *required*

L'identifiant unique de l'utilisateur.

Exemple : `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

Le nom d'affichage de l'utilisateur présenté sur son profil public.

Exemple : `John Doe`

**username** `string` *required*

Le nom d'utilisateur unique de l'utilisateur présenté sur son profil public.

Exemple : `johndoe42`

**dashboard\_path** `string | null` *required*

Le modèle de chemin d'URL pour une vue spécifique de cette application, ajouté au domaine de base (par ex. '/experiences/\[experienceId]'). Null si le type de vue spécifié n'est pas configuré.

Exemple : `/experiences/[experienceId]`

**default\_api\_key** `object | null` *required*

La clé API par défaut de l'application, utilisée pour authentifier les requêtes au nom de cette application. Null si l'application n'a pas de clé par défaut. Nécessite l'autorisation 'developer:manage\_api\_key'.

**attributs enfants**

**id** `string` *required*

L'identifiant unique de la clé API autorisée.

**name** `string | null` *required*

Un nom défini par l'utilisateur pour identifier une clé API

**obfuscated\_secret\_key** `string` *required*

Une version masquée de la clé secrète utilisée pour authentifier les requêtes. Cela permet au propriétaire d'identifier facilement la clé sans afficher le secret complet.

**secret\_key** `string | null` *required*

La clé secrète utilisée pour authentifier les requêtes. Elle n'est disponible que si l'acteur actuel aurait pu créer cette clé API.

**description** `string | null` *required*

Une description écrite de ce que fait cette application, affichée sur la page de l'application dans l'app store. Null si aucune description n'a été définie.

Exemple : `A comprehensive analytics dashboard for tracking revenue,…`

**discover\_path** `string | null` *required*

Le modèle de chemin d'URL pour une vue spécifique de cette application, ajouté au domaine de base (par ex. '/experiences/\[experienceId]'). Null si le type de vue spécifié n'est pas configuré.

Exemple : `/experiences/[experienceId]`

**domain\_id** `string` *required*

L'identifiant de sous-domaine unique de l'URL proxifiée de cette application sur la plateforme Whop. Forme le modèle d'URL https\://\{domain\_id}.apps.whop.com.

Exemple : `ab1c2d3e4f5g6h7i8j9k`

**experience\_path** `string | null` *required*

Le modèle de chemin d'URL pour une vue spécifique de cette application, ajouté au domaine de base (par ex. '/experiences/\[experienceId]'). Null si le type de vue spécifié n'est pas configuré.

Exemple : `/experiences/[experienceId]`

**hosted\_url** `string | null` *required*

L'URL canonique complète à laquelle le build web hébergé de cette application est servi. Null si l'application n'a pas réservé de route.

Exemple : `https://myapp.whop.site`

**icon** `object | null` *required*

L'image d'icône de cette application, affichée dans l'app store, sur les pages produit, au checkout, et comme icône par défaut des expériences utilisant cette application.

**attributs enfants**

**url** `string | null` *required*

Une URL pré-optimisée pour afficher cette pièce jointe côté client. Elle doit être utilisée pour afficher les pièces jointes dans les applications.

Exemple : `https://media.whop.com/abc123/optimized.jpg`

**id** `string` *required*

L'identifiant unique de l'application.

Exemple : `app_xxxxxxxxxxxxxx`

**marketplace\_status** `MarketplaceStatuses | null` *required*

Le statut d'approbation de la fiche produit de cette application dans l'app store Whop. Null si l'application n'a pas de produit associé.

Options disponibles : `not_available`, `pending_review`, `live_marketplace`

**name** `string` *required*

Le nom d'affichage de cette application présenté dans l'app store et dans la navigation des expériences. 30 caractères maximum.

Exemple : `Courses`

**oauth\_client\_type** `AppOauthClientTypes` *required*

La manière dont cette application s'authentifie lors de l'échange des autorisations OAuth et des jetons d'actualisation.

Options disponibles : `public`, `confidential`

**openapi\_path** `string | null` *required*

Le modèle de chemin d'URL pour une vue spécifique de cette application, ajouté au domaine de base (par ex. '/experiences/\[experienceId]'). Null si le type de vue spécifié n'est pas configuré.

Exemple : `/experiences/[experienceId]`

**origin** `string | null` *required*

L'URL d'origine complète du domaine proxifié de cette application (par ex. '[https://myapp.apps.whop.com](https://myapp.apps.whop.com)'). Null si aucun domaine proxy n'est configuré.

**product\_id** `string | null` *required*

**production\_web\_build** `object | null` *required*

Le build d'application approuvé actuellement servi aux utilisateurs sur le web. Null si aucun build de production n'est déployé pour le web.

**attributs enfants**

**checksum** `string` *required*

Un hash SHA-256 du fichier de build téléversé, généré par le client et utilisé pour vérifier l'intégrité du fichier.

Exemple : `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7…`

**file\_url** `string` *required*

Une URL pour télécharger le build d'application sous forme d'archive .zip.

Exemple : `https://cdn.whop.com/builds/abc123.zip`

**id** `string` *required*

L'identifiant unique du build d'application.

Exemple : `apbu_xxxxxxxxxxxxx`

**source\_url** `string | null` *required*

Une URL pour télécharger l'archive compressée du code source ayant produit ce build. Null si le build a été téléversé sans archive source.

Exemple : `https://cdn.whop.com/builds/abc123-source.zip`

**status** `AppBuildStatuses` *required*

Le statut d'examen actuel de ce build.

Options disponibles : `draft`, `pending`, `approved`, `rejected`

**redirect\_uris** `array\<string\>` *required*

Les URL de rappel OAuth autorisées vers lesquelles les utilisateurs sont redirigés après avoir autorisé l'application.

**requested\_permissions** `array\<object\>` *required*

La liste des autorisations demandées par cette application lors de son installation, y compris les autorisations obligatoires et facultatives avec leurs justifications.

**attributs enfants**

**is\_required** `boolean` *required*

Indique si l'action est nécessaire au fonctionnement de l'application.

**justification** `string` *required*

La raison de la demande de l'action.

**permission\_action** `object` *required*

L'action que l'application demandera aux utilisateurs lorsqu'un utilisateur installe l'application.

**attributs enfants**

**action** `string` *required*

L'identifiant de l'action.

**name** `string` *required*

Le nom lisible de l'action.

**route** `string | null` *required*

La route de sous-domaine unique où les builds web hébergés de cette application sont servis, comme 'myapp' pour myapp.whop.site. Null si l'application n'a pas réservé de route.

Exemple : `myapp`

**secrets** `object | null` *required*

Les secrets de l'application sous forme d'objet de valeurs de type chaîne. Chiffrés au repos et injectés dans l'environnement d'exécution du serveur hébergé de l'application sous forme de liaisons d'environnement. Nécessite l'autorisation 'developer:update\_app'.

**skills\_path** `string | null` *required*

Le modèle de chemin d'URL pour une vue spécifique de cette application, ajouté au domaine de base (par ex. '/experiences/\[experienceId]'). Null si le type de vue spécifié n'est pas configuré.

Exemple : `/experiences/[experienceId]`

**stats** `object | null` *required*

Statistiques d'utilisation agrégées de cette application, y compris le nombre d'utilisateurs actifs quotidiens, hebdomadaires et mensuels.

**attributs enfants**

**dau** `integer` *required*

Le nombre d'utilisateurs uniques ayant passé du temps dans cette application au cours des dernières 24 heures. Renvoie 0 si aucune donnée d'utilisation n'est disponible.

Exemple : `42`

**mau** `integer` *required*

Le nombre d'utilisateurs uniques ayant passé du temps dans cette application au cours des 28 derniers jours. Renvoie 0 si aucune donnée d'utilisation n'est disponible.

Exemple : `42`

**time\_spent\_last24\_hours** `integer` *required*

Le temps total, en secondes, passé par l'ensemble des utilisateurs dans cette application au cours des dernières 24 heures. Renvoie 0 si aucune donnée d'utilisation n'est disponible.

Exemple : `42`

**wau** `integer` *required*

Le nombre d'utilisateurs uniques ayant passé du temps dans cette application au cours des 7 derniers jours. Renvoie 0 si aucune donnée d'utilisation n'est disponible.

Exemple : `42`

**status** `AppStatuses` *required*

Le statut de visibilité actuel de cette application dans l'app store Whop. 'live' signifie visible publiquement, 'unlisted' signifie accessible uniquement via un lien direct, et 'hidden' signifie visible nulle part.

Options disponibles : `live`, `unlisted`, `hidden`

**verified** `boolean` *required*

Indique si cette application a été vérifiée par Whop. Les applications vérifiées sont approuvées par Whop et affichées dans la section des applications en vedette de l'app store.


## Related topics

- [Create Financing Application](https://docs.whop.com/fr/api-reference/financing-applications/create-financing-application.md)
- [Vues d'application](https://docs.whop.com/fr/developer/guides/app-views.md)
- [Update Financing Application](https://docs.whop.com/fr/api-reference/financing-applications/update-financing-application.md)
