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

# Uygulama

> Uygulama, Whop üzerine inşa edilmiş bir entegrasyondur. Uygulamalar tüketicilere ürünler içinde deneyimler olarak veya şirketlere iş araçları olarak hizmet verebilir.

> [!NOTE]
>
> Bu kaynağın, yeni entegrasyonların üzerine inşa edilmesi gereken sürümlü API olan [Güncel API](https://docs.whop.com/tr/api-reference/legacy/apps/app.md) içinde bir halefi vardır. Bu sayfa tam olarak desteklenmeye devam eder.

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

Bu uygulama adına isteklerin kimliğini doğrulamak için kullanılan API anahtarı. API anahtarı oluşturulmadıysa null. 'developer:manage\_api\_key' iznini gerektirir.

**alt öznitelikler**

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

Özel API anahtarının oluşturulduğu tarih ve saat.

Örnek: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

Özel API anahtarının benzersiz tanımlayıcısı.

**token** `string` *required*

Bu, isteklerin kimliğini doğrulamak için kullanılan API anahtarıdır

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

Bu uygulamanın hedef kitle sınıflandırması (ör. 'b2b\_app', 'b2c\_app', 'company\_app', 'component').

Kullanılabilir seçenekler: `b2b_app`, `b2c_app`, `company_app`, `component`, `website`

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

Uygulamanın barındırıldığı üretim temel URL'si. Temel URL yapılandırılmadıysa veya çağıranın uygulamanın hesabında `developer:basic:read` izni yoksa `null`.

Örnek: `https://myapp.example.com`

**company** `object` *required*

Bu uygulamanın sahibi olan ve onu yayımlayan şirket.

**alt öznitelikler**

**id** `string` *required*

Şirketin benzersiz tanımlayıcısı.

Örnek: `biz_xxxxxxxxxxxxxx`

**title** `string` *required*

Müşterilere gösterilen şirketin görünen adı.

Örnek: `Pickaxe`

**creator** `object` *required*

Bu uygulamayı yayımlayan şirketi oluşturan ve ona sahip olan kullanıcı.

**alt öznitelikler**

**id** `string` *required*

Kullanıcının benzersiz tanımlayıcısı.

Örnek: `user_xxxxxxxxxxxxx`

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

Kullanıcının herkese açık profilinde gösterilen görünen adı.

Örnek: `John Doe`

**username** `string` *required*

Kullanıcının herkese açık profilinde gösterilen benzersiz kullanıcı adı.

Örnek: `johndoe42`

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

Bu uygulamanın belirli bir görünümü için temel alan adına eklenen URL yolu şablonu (ör. '/experiences/\[experienceId]'). Belirtilen görünüm türü yapılandırılmadıysa null.

Örnek: `/experiences/[experienceId]`

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

Bu uygulama adına isteklerin kimliğini doğrulamak için kullanılan uygulamanın varsayılan API anahtarı. Uygulamanın varsayılan anahtarı yoksa null. 'developer:manage\_api\_key' iznini gerektirir.

**alt öznitelikler**

**id** `string` *required*

Yetkilendirilmiş API anahtarının benzersiz tanımlayıcısı.

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

Bir API anahtarını tanımlamak için kullanıcının belirlediği ad

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

İsteklerin kimliğini doğrulamak için kullanılan gizli anahtarın maskelenmiş sürümü. Bu, sahibin tam gizli anahtar gösterilmeden hangi anahtar olduğunu kolayca tanımlayabilmesi içindir.

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

İsteklerin kimliğini doğrulamak için kullanılan gizli anahtar. Bu yalnızca mevcut aktör bu API anahtarını oluşturabilecek durumdaysa kullanılabilir.

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

Bu uygulamanın ne yaptığına dair, uygulama mağazası listeleme sayfasında gösterilen yazılı açıklama. Açıklama ayarlanmadıysa null.

Örnek: `A comprehensive analytics dashboard for tracking revenue,…`

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

Bu uygulamanın belirli bir görünümü için temel alan adına eklenen URL yolu şablonu (ör. '/experiences/\[experienceId]'). Belirtilen görünüm türü yapılandırılmadıysa null.

Örnek: `/experiences/[experienceId]`

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

Bu uygulamanın Whop platformundaki proxy URL'si için benzersiz alt alan adı tanımlayıcısı. https\://\{domain\_id}.apps.whop.com URL desenini oluşturur.

Örnek: `ab1c2d3e4f5g6h7i8j9k`

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

Bu uygulamanın belirli bir görünümü için temel alan adına eklenen URL yolu şablonu (ör. '/experiences/\[experienceId]'). Belirtilen görünüm türü yapılandırılmadıysa null.

Örnek: `/experiences/[experienceId]`

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

Bu uygulamanın barındırılan web derlemesinin sunulduğu tam kanonik URL. Uygulama bir rota talep etmediyse null.

Örnek: `https://myapp.whop.site`

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

Uygulama mağazasında, ürün sayfalarında, ödeme sayfasında ve bu uygulamayı kullanan deneyimler için varsayılan simge olarak gösterilen bu uygulamanın simge görseli.

**alt öznitelikler**

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

Bu eki istemcide işlemek için önceden optimize edilmiş bir URL. Uygulamalarda ekleri görüntülemek için bu kullanılmalıdır.

Örnek: `https://media.whop.com/abc123/optimized.jpg`

**id** `string` *required*

Uygulamanın benzersiz tanımlayıcısı.

Örnek: `app_xxxxxxxxxxxxxx`

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

Bu uygulamanın Whop uygulama mağazasındaki ürün listesinin onay durumu. Uygulamanın ilişkili ürünü yoksa null.

Kullanılabilir seçenekler: `not_available`, `pending_review`, `live_marketplace`

**name** `string` *required*

Bu uygulamanın uygulama mağazasında ve deneyim gezinmesinde gösterilen görünen adı. En fazla 30 karakter.

Örnek: `Courses`

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

Bu uygulamanın OAuth yetkilendirme ve yenileme izinlerini takas ederken nasıl kimlik doğruladığı.

Kullanılabilir seçenekler: `public`, `confidential`

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

Bu uygulamanın belirli bir görünümü için temel alan adına eklenen URL yolu şablonu (ör. '/experiences/\[experienceId]'). Belirtilen görünüm türü yapılandırılmadıysa null.

Örnek: `/experiences/[experienceId]`

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

Bu uygulamanın proxy alan adı için tam kaynak URL'si (ör. '[https://myapp.apps.whop.com](https://myapp.apps.whop.com)'). Proxy alan adı yapılandırılmadıysa null.

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

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

Web'de kullanıcılara şu anda sunulan onaylı uygulama derlemesi. Web için dağıtılmış bir üretim derlemesi yoksa null.

**alt öznitelikler**

**checksum** `string` *required*

İstemci tarafından oluşturulan ve dosya bütünlüğünü doğrulamak için kullanılan, yüklenen derleme dosyasının SHA-256 hash'i.

Örnek: `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7…`

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

Uygulama derlemesini .zip arşivi olarak indirmek için bir URL.

Örnek: `https://cdn.whop.com/builds/abc123.zip`

**id** `string` *required*

Uygulama derlemesinin benzersiz tanımlayıcısı.

Örnek: `apbu_xxxxxxxxxxxxx`

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

Bu derlemeyi üreten sıkıştırılmış kaynak kodu arşivini indirmek için bir URL. Derleme kaynak arşivi olmadan yüklendiyse null.

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

**status** `AppBuildStatuses` *required*

Bu derlemenin mevcut inceleme durumu.

Kullanılabilir seçenekler: `draft`, `pending`, `approved`, `rejected`

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

Kullanıcıların uygulamayı yetkilendirdikten sonra yönlendirildiği beyaz listedeki OAuth geri çağırma URL'leri.

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

Bu uygulamanın kurulduğunda talep ettiği, gerekçeleriyle birlikte hem zorunlu hem isteğe bağlı izinleri içeren izin listesi.

**alt öznitelikler**

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

Uygulamanın çalışması için bu eylemin gerekli olup olmadığı.

**justification** `string` *required*

Eylemi talep etme nedeni.

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

Bir kullanıcı uygulamayı kurduğunda uygulamanın kullanıcılardan talep edeceği eylem.

**alt öznitelikler**

**action** `string` *required*

Eylemin tanımlayıcısı.

**name** `string` *required*

Eylemin insan tarafından okunabilir adı.

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

Bu uygulamanın barındırılan web derlemelerinin sunulduğu benzersiz alt alan adı rotası; örneğin myapp.whop.site için 'myapp'. Uygulama bir rota talep etmediyse null.

Örnek: `myapp`

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

Uygulamanın gizli değerleri, dize değerlerinden oluşan bir nesne olarak. Bekleme halinde şifrelenir ve uygulamanın barındırılan sunucu çalışma zamanına ortam bağlamaları olarak enjekte edilir. 'developer:update\_app' iznini gerektirir.

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

Bu uygulamanın belirli bir görünümü için temel alan adına eklenen URL yolu şablonu (ör. '/experiences/\[experienceId]'). Belirtilen görünüm türü yapılandırılmadıysa null.

Örnek: `/experiences/[experienceId]`

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

Bu uygulama için günlük, haftalık ve aylık aktif kullanıcı sayıları dahil toplu kullanım istatistikleri.

**alt öznitelikler**

**dau** `integer` *required*

Son 24 saatte bu uygulamada zaman geçiren benzersiz kullanıcı sayısı. Kullanım verisi yoksa 0 döndürür.

Örnek: `42`

**mau** `integer` *required*

Son 28 günde bu uygulamada zaman geçiren benzersiz kullanıcı sayısı. Kullanım verisi yoksa 0 döndürür.

Örnek: `42`

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

Tüm kullanıcıların son 24 saatte bu uygulamada geçirdiği saniye cinsinden toplam süre. Kullanım verisi yoksa 0 döndürür.

Örnek: `42`

**wau** `integer` *required*

Son 7 günde bu uygulamada zaman geçiren benzersiz kullanıcı sayısı. Kullanım verisi yoksa 0 döndürür.

Örnek: `42`

**status** `AppStatuses` *required*

Bu uygulamanın Whop uygulama mağazasındaki mevcut görünürlük durumu. 'live' herkese açık olarak keşfedilebilir, 'unlisted' yalnızca doğrudan bağlantıyla erişilebilir, 'hidden' ise hiçbir yerde görünmez anlamına gelir.

Kullanılabilir seçenekler: `live`, `unlisted`, `hidden`

**verified** `boolean` *required*

Bu uygulamanın Whop tarafından doğrulanıp doğrulanmadığı. Doğrulanmış uygulamalar Whop tarafından onaylanır ve uygulama mağazasının öne çıkan uygulamalar bölümünde gösterilir.


## Related topics

- [Uygulama Kurulumları](https://docs.whop.com/tr/developer/guides/app-installations.md)
- [Uygulama Görünümleri](https://docs.whop.com/tr/developer/guides/app-views.md)
- [Uygulama Derlemesi](https://docs.whop.com/tr/api-reference/legacy/app-builds/app-build.md)
