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

# App

> 앱은 Whop 위에 구축된 통합입니다. 앱은 상품 내 경험으로 소비자에게 제공되거나, 비즈니스 도구로 회사에 제공될 수 있습니다.

> [!NOTE]
>
> 이 리소스에는 신규 통합이 기반으로 삼아야 하는 버전 지정 API인 [Current API](https://docs.whop.com/ko/api-reference/legacy/apps/app.md)에 후속 리소스가 있습니다. 이 페이지는 계속 완전히 지원됩니다.

```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*

이 앱을 대신하여 요청을 인증하는 데 사용되는 API 키입니다. API 키가 생성되지 않은 경우 Null입니다. 'developer:manage\_api\_key' 권한이 필요합니다.

**하위 속성**

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

비공개 API 키가 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

비공개 API 키의 고유 식별자입니다.

**token** `string` *required*

요청을 인증하는 데 사용되는 API 키입니다

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

이 앱의 대상 사용자 분류입니다(예: 'b2b\_app', 'b2c\_app', 'company\_app', 'component').

사용 가능한 옵션: `b2b_app`, `b2c_app`, `company_app`, `component`, `website`

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

앱이 호스팅되는 프로덕션 기본 URL입니다. 기본 URL이 구성되지 않았거나 호출자에게 앱 계정에 대한 `developer:basic:read` 권한이 없으면 `null`입니다.

예시: `https://myapp.example.com`

**company** `object` *required*

이 앱을 소유하고 게시한 회사입니다.

**하위 속성**

**id** `string` *required*

회사의 고유 식별자입니다.

예시: `biz_xxxxxxxxxxxxxx`

**title** `string` *required*

고객에게 표시되는 회사의 표시 이름입니다.

예시: `Pickaxe`

**creator** `object` *required*

이 앱을 게시한 회사를 생성하고 소유한 사용자입니다.

**하위 속성**

**id** `string` *required*

사용자의 고유 식별자입니다.

예시: `user_xxxxxxxxxxxxx`

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

공개 프로필에 표시되는 사용자의 표시 이름입니다.

예시: `John Doe`

**username** `string` *required*

공개 프로필에 표시되는 사용자의 고유 사용자 이름입니다.

예시: `johndoe42`

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

기본 도메인에 추가되는 이 앱의 특정 뷰에 대한 URL 경로 템플릿입니다(예: '/experiences/\[experienceId]'). 지정된 뷰 유형이 구성되지 않은 경우 Null입니다.

예시: `/experiences/[experienceId]`

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

이 앱을 대신하여 요청을 인증하는 데 사용되는 앱의 기본 API 키입니다. 앱에 기본 키가 없으면 Null입니다. 'developer:manage\_api\_key' 권한이 필요합니다.

**하위 속성**

**id** `string` *required*

인증된 API 키의 고유 식별자입니다.

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

API 키를 식별하기 위해 사용자가 설정한 이름

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

요청을 인증하는 데 사용되는 비밀 키의 마스킹된 버전입니다. 소유자가 전체 비밀 키를 보지 않고도 어떤 키인지 쉽게 식별할 수 있도록 하기 위한 것입니다.

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

요청을 인증하는 데 사용되는 비밀 키입니다. 현재 행위자가 이 API 키를 생성할 수 있었던 경우에만 제공됩니다.

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

앱 스토어 목록 페이지에 표시되는, 이 앱이 하는 일에 대한 설명입니다. 설명이 설정되지 않은 경우 Null입니다.

예시: `A comprehensive analytics dashboard for tracking revenue,…`

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

기본 도메인에 추가되는 이 앱의 특정 뷰에 대한 URL 경로 템플릿입니다(예: '/experiences/\[experienceId]'). 지정된 뷰 유형이 구성되지 않은 경우 Null입니다.

예시: `/experiences/[experienceId]`

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

Whop 플랫폼에서 이 앱의 프록시 URL에 사용되는 고유 서브도메인 식별자입니다. https\://\{domain\_id}.apps.whop.com 형식의 URL을 구성합니다.

예시: `ab1c2d3e4f5g6h7i8j9k`

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

기본 도메인에 추가되는 이 앱의 특정 뷰에 대한 URL 경로 템플릿입니다(예: '/experiences/\[experienceId]'). 지정된 뷰 유형이 구성되지 않은 경우 Null입니다.

예시: `/experiences/[experienceId]`

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

이 앱의 호스팅된 웹 빌드가 제공되는 전체 정식 URL입니다. 앱이 라우트를 확보하지 않은 경우 Null입니다.

예시: `https://myapp.whop.site`

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

이 앱의 아이콘 이미지로, 앱 스토어, 상품 페이지, 체크아웃에 표시되며 이 앱을 사용하는 경험의 기본 아이콘으로 사용됩니다.

**하위 속성**

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

클라이언트에서 이 첨부 파일을 렌더링하기 위해 사전 최적화된 URL입니다. 앱에서 첨부 파일을 표시할 때 사용해야 합니다.

예시: `https://media.whop.com/abc123/optimized.jpg`

**id** `string` *required*

앱의 고유 식별자입니다.

예시: `app_xxxxxxxxxxxxxx`

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

Whop 앱 스토어에서 이 앱의 상품 목록에 대한 승인 상태입니다. 앱에 연결된 상품이 없으면 Null입니다.

사용 가능한 옵션: `not_available`, `pending_review`, `live_marketplace`

**name** `string` *required*

앱 스토어와 경험 내비게이션에 표시되는 이 앱의 표시 이름입니다. 최대 30자입니다.

예시: `Courses`

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

OAuth 인증 및 갱신 그랜트를 교환할 때 이 앱이 인증하는 방식입니다.

사용 가능한 옵션: `public`, `confidential`

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

기본 도메인에 추가되는 이 앱의 특정 뷰에 대한 URL 경로 템플릿입니다(예: '/experiences/\[experienceId]'). 지정된 뷰 유형이 구성되지 않은 경우 Null입니다.

예시: `/experiences/[experienceId]`

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

이 앱의 프록시 도메인에 대한 전체 오리진 URL입니다(예: '[https://myapp.apps.whop.com](https://myapp.apps.whop.com)'). 프록시 도메인이 구성되지 않은 경우 Null입니다.

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

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

현재 웹에서 사용자에게 제공되는 승인된 앱 빌드입니다. 웹용 프로덕션 빌드가 배포되지 않은 경우 Null입니다.

**하위 속성**

**checksum** `string` *required*

클라이언트가 생성한 업로드된 빌드 파일의 SHA-256 해시로, 파일 무결성을 확인하는 데 사용됩니다.

예시: `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7…`

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

앱 빌드를 .zip 아카이브로 다운로드할 수 있는 URL입니다.

예시: `https://cdn.whop.com/builds/abc123.zip`

**id** `string` *required*

앱 빌드의 고유 식별자입니다.

예시: `apbu_xxxxxxxxxxxxx`

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

이 빌드를 생성한 압축 소스 코드 아카이브를 다운로드할 수 있는 URL입니다. 소스 아카이브 없이 빌드가 업로드된 경우 Null입니다.

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

**status** `AppBuildStatuses` *required*

이 빌드의 현재 검토 상태입니다.

사용 가능한 옵션: `draft`, `pending`, `approved`, `rejected`

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

사용자가 앱을 승인한 후 리디렉션되는 허용 목록에 등록된 OAuth 콜백 URL입니다.

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

설치 시 이 앱이 요청하는 권한 목록으로, 필수 권한과 선택 권한 모두를 사유와 함께 포함합니다.

**하위 속성**

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

앱이 작동하는 데 해당 작업이 필수인지 여부입니다.

**justification** `string` *required*

해당 작업을 요청하는 이유입니다.

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

사용자가 앱을 설치할 때 앱이 사용자에게 요청하는 작업입니다.

**하위 속성**

**action** `string` *required*

작업의 식별자입니다.

**name** `string` *required*

사람이 읽을 수 있는 작업 이름입니다.

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

이 앱의 호스팅된 웹 빌드가 제공되는 고유 서브도메인 라우트입니다(예: myapp.whop.site의 경우 'myapp'). 앱이 라우트를 확보하지 않은 경우 Null입니다.

예시: `myapp`

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

문자열 값 객체 형태의 앱 시크릿입니다. 저장 시 암호화되며 앱의 호스팅 서버 런타임에 환경 바인딩으로 주입됩니다. 'developer:update\_app' 권한이 필요합니다.

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

기본 도메인에 추가되는 이 앱의 특정 뷰에 대한 URL 경로 템플릿입니다(예: '/experiences/\[experienceId]'). 지정된 뷰 유형이 구성되지 않은 경우 Null입니다.

예시: `/experiences/[experienceId]`

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

일간, 주간, 월간 활성 사용자 수를 포함한 이 앱의 집계 사용 통계입니다.

**하위 속성**

**dau** `integer` *required*

지난 24시간 동안 이 앱에서 시간을 보낸 고유 사용자 수입니다. 사용 데이터가 없으면 0을 반환합니다.

예시: `42`

**mau** `integer` *required*

지난 28일 동안 이 앱에서 시간을 보낸 고유 사용자 수입니다. 사용 데이터가 없으면 0을 반환합니다.

예시: `42`

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

지난 24시간 동안 모든 사용자가 이 앱에서 보낸 총 시간(초)입니다. 사용 데이터가 없으면 0을 반환합니다.

예시: `42`

**wau** `integer` *required*

지난 7일 동안 이 앱에서 시간을 보낸 고유 사용자 수입니다. 사용 데이터가 없으면 0을 반환합니다.

예시: `42`

**status** `AppStatuses` *required*

Whop 앱 스토어에서 이 앱의 현재 공개 상태입니다. 'live'는 공개적으로 검색 가능함을, 'unlisted'는 직접 링크로만 접근 가능함을, 'hidden'은 어디에도 표시되지 않음을 의미합니다.

사용 가능한 옵션: `live`, `unlisted`, `hidden`

**verified** `boolean` *required*

이 앱이 Whop의 인증을 받았는지 여부입니다. 인증된 앱은 Whop이 보증하며 앱 스토어의 추천 앱 섹션에 표시됩니다.


## Related topics

- [Apps API](https://docs.whop.com/ko/api-reference/apps/app.md)
- [List Apps](https://docs.whop.com/ko/api-reference/apps/list-apps.md)
- [Update App](https://docs.whop.com/ko/api-reference/apps/update-app.md)
