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

# Deneyler API'si

> Deney, bir hesaba ait bir özellik bayrağı veya A/B testidir.

Uygulamalar (treatment) trafiğin sabit yüzde aralıklarını alır ve geri kalan herkes kontrol grubuna düşer; böylece bir tahsisi büyütmek mevcut bir kullanıcıyı hiçbir zaman başka bir kola taşımaz.

Deneyler API'sini bir taslak oluşturmak, ağırlıklarını, hedeflemesini ve kaynak bağlamalarını yapılandırmak, ardından etkinleştirmek, duraklatmak veya sonlandırmak ve bir kullanıcının, hesabın veya anonim ziyaretçinin hangi kolu aldığını değerlendirmek için kullanın. Deneyleri yönetmek `experiment:read` veya `experiment:manage` gerektirir; değerlendirme kimlik doğrulaması olmadan çalışır.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Deneyleri Listele](https://docs.whop.com/tr/api-reference/experiments/list-experiments.md) | GET `/experiments` |
| [Deneyi Al](https://docs.whop.com/tr/api-reference/experiments/retrieve-experiment.md) | GET `/experiments/{id}` |
| [Deneyleri Değerlendir](https://docs.whop.com/tr/api-reference/experiments/evaluate-experiments.md) | GET `/experiments/exposures` |
| [Deney Oluştur](https://docs.whop.com/tr/api-reference/experiments/create-experiment.md) | POST `/experiments` |
| [Deneyi Etkinleştir](https://docs.whop.com/tr/api-reference/experiments/activate-experiment.md) | POST `/experiments/{id}/activate` |
| [Deneyi Sonlandır](https://docs.whop.com/tr/api-reference/experiments/end-experiment.md) | POST `/experiments/{id}/end` |
| [Deneyi Duraklat](https://docs.whop.com/tr/api-reference/experiments/pause-experiment.md) | POST `/experiments/{id}/pause` |
| [Deneyi Güncelle](https://docs.whop.com/tr/api-reference/experiments/update-experiment.md) | PATCH `/experiments/{id}` |

## Öznitelikler

**id** `string` *required*

Deney için `expt_` önekli benzersiz tanımlayıcı.

**account\_id** `string` *required*

Sahip hesap kimliği.

**assignment\_seed** `string` *required*

Atama, UTF-8 tohum + konu kimliğini CRC32 ile mod 100 olarak karma işleminden geçirir ve kayıtlı, sonu hariç aralığı seçer.

**bucket\_by** `string | null`

Rastgeleleştirme birimi — `user` her kullanıcıyı bağımsız olarak gruplar, `account` tüm hesapları gruplar (bir hesabın her kullanıcısı aynı kolu alır). Özellik bayrakları için `null`.

Kullanılabilir seçenekler: `user`, `account`, `anonymous`

**configuration\_revision** `integer` *required*

Sunum yapılandırmasının revizyonu. Her yapılandırma değişikliğinde artar, bu nedenle daha düşük revizyonlu önbelleğe alınmış bir tanım eskidir. Atama tohumunu değiştirmez.

**control** `object` *required*

> [accordion] Özellikler
>
> **related\_resource** `object | null`
>
> > [accordion] Özellikler
> >
> > **id** `string` *required*
> >
> > Deney sahibine ait, başvurulan kaynak etiketi.
> >
> > **object** `string` *required*
> >
> > Kullanılabilir seçenekler: `app`, `app_build`, `product`, `plan`

**created\_at** `string | null`

Deneyin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**created\_by** `string | null`

Deneyi oluşturan kullanıcının `user_` önekli kimliği. Oluşturanlar kaydedilmeye başlanmadan önce oluşturulan deneyler için `null`.

**ended\_at** `string | null`

Deneyin veri toplamayı durdurduğu zaman, ISO 8601 zaman damgası olarak. Hâlâ çalışırken `null`.

**findings** `string | null`

Deney sonlandırıldığında kaydedilen, neyin öğrenildiği ve neden bu sonucun çıktığı. O zamana kadar `null`.

**flag\_key** `string` *required*

Koddan başvurulan, geliştiricinin seçtiği tanıtıcı. API'nin bir deney tanımlayıcısı aldığı her yerde `expt_` kimliği ve flag\_key birbirinin yerine kullanılabilir.

**hypothesis** `string | null`

Bu deneyin hipotezi. Ayarlanmamışsa `null` ve özellik bayrakları için her zaman `null`.

**metadata** `object`

Deney oluşturulduğunda eklenen anahtar-değer çiftleri. Hiçbiri ayarlanmadıysa boştur.

**name** `string` *required*

İnsan tarafından okunabilir görünen ad.

**related\_resource** `object | null` *required*

Hesaba ait olan ve bu deneyin bağlı olduğu kaynak, örneğin bir uygulama veya ürün. Bağlı değilse `null`. Deney ilk kez etkinleştirildiğinde sabitlenir.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Deney sahibine ait, başvurulan kaynak etiketi.
>
> **object** `string` *required*
>
> Kullanılabilir seçenekler: `app`, `app_build`, `product`, `plan`

**started\_at** `string | null`

Deneyin veri toplamaya başladığı zaman, ISO 8601 zaman damgası olarak. Taslaklar için `null`.

**status** `string` *required*

Yaşam döngüsü durumu. `draft` — henüz yayında değil; `active` — şu anda çalışıyor; `paused` — trafik duraklatıldı; `ended` — sonuçlandı.

Kullanılabilir seçenekler: `draft`, `active`, `paused`, `ended`

**updated\_at** `string | null` *required*

**variants** `object[]` *required*

Uygulama kolları. Tüm kolların tahsisi dışında kalan kullanıcılar örtük `control` grubunu oluşturur. Ağırlıklar yalnızca artar ve kollar hiçbir zaman kaldırılmaz; böylece bir kullanıcı kontrol grubundan bir uygulamaya en fazla bir kez geçer.

> [accordion] Özellikler
>
> **name** `string` *required*
>
> Uygulama tanımlayıcısı. `control` ayrılmıştır — örtük kalandır.
>
> **ranges** `integer[][]`
>
> Bu kolun tahsis geçmişini kaydeden verilmiş grup aralıkları (%1'lik birimler, sonu hariç). Sunucu tarafından yönetilir; aralıklara yalnızca ekleme yapılır ve atamaları kalıcı kılan da budur.
>
> **related\_resource** `object | null`
>
> > [accordion] Özellikler
> >
> > **id** `string` *required*
> >
> > Deney sahibine ait, başvurulan kaynak etiketi.
> >
> > **object** `string` *required*
> >
> > Kullanılabilir seçenekler: `app`, `app_build`, `product`, `plan`
>
> **weight** `integer` *required*
>
> Bu uygulamaya atanan tüm kullanıcıların yüzdesi, 1–100. Tüm ağırlıkların toplamı en fazla 100'dür; kalan kontrol grubudur.

**winning\_arm** `string | null`

Deney sonlandırıldığında ayarlanan kazanan uygulama. Ayarlandıktan sonra her değerlendirme, hedefleme veya tahsisten bağımsız olarak her çağırana bu kolu döndürür ve başka maruz kalma kaydedilmez. `null` kontrol grubunun kazandığı anlamına gelir — kazanan kolu olmayan sonlandırılmış bir deney herkes için `control` olarak değerlendirilir. Sonlandırıldığında basitçe devre dışı olarak değerlendirilen özellik bayrakları için her zaman `null`.

```json Experiment theme={null}
{
	"id": "expt_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"flag_key": "checkout_redesign_v2",
	"name": "Checkout Redesign V2",
	"hypothesis": "A single-step checkout raises conversion.",
	"status": "active",
	"bucket_by": "user",
	"assignment_seed": "checkout_redesign_v21789462000",
	"configuration_revision": 2,
	"variants": [
		{
			"name": "treatment",
			"weight": 50,
			"ranges": [[0, 50]],
			"related_resource": null
		}
	],
	"control": {
		"related_resource": null
	},
	"related_resource": null,
	"winning_arm": null,
	"findings": null,
	"created_by": "user_xxxxxxxxxxxxxx",
	"created_at": "2026-09-01T12:00:00.000Z",
	"started_at": "2026-09-02T09:00:00.000Z",
	"ended_at": null,
	"updated_at": "2026-09-02T09:00:00.000Z"
}
```


## Related topics

- [Kartlar API'si](https://docs.whop.com/tr/api-reference/cards/card.md)
- [Kanallar API'si](https://docs.whop.com/tr/api-reference/channels/channel.md)
- [İşlemler API'si](https://docs.whop.com/tr/api-reference/trades/trade.md)
