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

# Kimlik Doğrulama ve API Anahtarları

> Beş Whop kimlik bilgisi türü, her birinin ne zaman kullanılacağı ve bir kimlik bilgisinin kapsamının gerçekten ihtiyaç duyduğu işlemlere nasıl daraltılacağı.

Whop'un beş kimlik bilgisi türü vardır. Hangisine ihtiyacınız olduğu, kimin verisine eriştiğinize ve kodun nerede çalıştığına bağlıdır. Bu tablodan seçin, ardından kimlik bilgisi üretime yaklaşmadan önce kapsamını daraltın.

| Kimlik bilgisi | Kimin adına çalışır | Nerede bulunur | Ne zaman kullanılır |
| - | - | - | - |
| **API anahtarı** | Hesabınız veya uygulamanız | Sunucunuz | Arka ucunuz kendi hesabınıza veya uygulamanızı kuran her hesaba erişir |
| **Hesap kapsamlı kullanıcı token'ı** | Tek bir hesap içindeki tek bir kullanıcı | Sunucunuzda oluşturulur, istemcinizde kullanılır | Ürününüzün zaten kendi kullanıcıları vardır ve onların Whop'ta oturum açmadan Whop'a erişmesi gerekir |
| **Hesap erişim token'ı** | Daraltılmış izinlerle hesabınız | Sunucunuzda oluşturulur, istemcinizde kullanılır | Bir istemcinin, API anahtarınızı tutmadan hesabınıza kısa süreli erişime ihtiyacı vardır |
| **iframe kullanıcı token'ı** | Uygulamanızı görüntüleyen kullanıcı | Whop tarafından gönderilir, sizin tarafınızdan doğrulanır | Uygulamanız Whop içinde görüntülenir ve ona kimin baktığını bilmeniz gerekir |
| **OAuth token'ı** | Whop'ta oturum açmış bir kullanıcı | OAuth akışından sonra sunucunuz | Kullanıcıların Whop ile oturum açmasını ve uygulamanıza hesaplarına erişim izni vermesini istersiniz |

## API anahtarları

Bir Account API anahtarı, sunucunuzun kimliğini tek bir hesap olarak doğrular. Bir App API anahtarı ise uygulamanızın kimliğini, onu kuran tüm hesaplarda doğrular. Her ikisi de gizlidir: bunları sunucu tarafında tutun.

### Bir Account API anahtarı oluşturun

Sunucunuz kendi hesabınız ve onun [alt hesapları](https://docs.whop.com/tr/developer/platforms/enroll-subaccounts.md) adına işlem yaptığında bir Account API anahtarı kullanın. Kontrol panelinin Developer sayfasında **Account API Keys** bölümünü açın ve **Create** seçeneğini seçin. [Hızlı başlangıç](https://docs.whop.com/tr/developer/quickstart.md) bunu sandbox'ta adım adım anlatır.

### Bir App API anahtarı oluşturun

Bir uygulama oluşturduğunuzda ve onu kuran hesaplardaki verilere erişmeniz gerektiğinde bir App API anahtarı kullanın.

1. Kontrol panelinde **Apps** bölümünü açın.
2. **Create app** seçeneğini seçin ve uygulamanıza bir ad verin. Adı daha sonra değiştirebilirsiniz.
3. Anahtarınız, **Environment variables** bölümünde `WHOP_API_KEY` ifadesinden sonraki gizli değerdir. Göstermek için gösterme düğmesini kullanın, ardından güvenli bir yerde saklayın.

## Hesap kapsamlı kullanıcı token'ları

Hesap kapsamlı bir kullanıcı token'ı, belirli bir hesap içindeki belirli bir kullanıcı olarak işlem yapar. Sunucunuz bunu API anahtarınızla oluşturur ve istemcinize iletir; böylece kullanıcılarınız Whop'ta hiç oturum açmadan Whop'a erişir.

`account_id`, `user_id` ve izin vermek istediğiniz işlemleri ileterek `POST /api/v1/access_tokens` ile bir tane oluşturun:

```bash theme={null}
curl https://api.whop.com/api/v1/access_tokens \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_XXXXXXXX",
    "user_id": "user_XXXXXXXX",
    "scoped_actions": ["chat:read", "chat:message:create"]
  }'
```

`account_id`, `biz_` ile ve `user_id`, `user_` ile başlar. API anahtarınızın her ikisine de erişim izni olmalıdır.

Token'ların süresi varsayılan olarak **bir saat** içinde dolar. Bunu değiştirmek için `expires_at` değerini en fazla **üç saate** kadar ayarlayın. Token'ları önbelleğe almak yerine ihtiyaç duyulduğunda oluşturun.

> [!NOTE]
>
> Bkz. [Erişim token'ı oluşturma](https://docs.whop.com/tr/api-reference/legacy/access-tokens/create-access-token.md).

### Bir token'ın kapsamını belirleme

`scoped_actions`, token'ın yapabileceği şeylerin listesidir. Her giriş, iki nokta üst üste ile ayrılmış bir işlem dizesidir.

> [!WARNING]
>
> `scoped_actions` değerini boş bırakırsanız veya hiç belirtmezseniz, token **onu oluşturan kimlik bilgisinin sahip olduğu tüm izinleri devralır**. Bu durumda bir tarayıcıya verilen token, API anahtarınızın tüm erişimini taşır. Her zaman açık bir liste iletin.

Bir işlem, token'ı oluşturan kimlik bilgisinin kendi izinlerinin bir alt kümesi olmalıdır. API anahtarınızın sahip olmadığı bir izni veremezsiniz.

Bu işlemler bugün Whop'un kılavuzlarında yer almaktadır:

| İşlem | Verdiği izin |
| - | - |
| `chat:read` | Sohbet kanallarını ve mesajlarını okuma |
| `chat:message:create` | Sohbet mesajları gönderme |
| `dms:read` | Doğrudan mesajları okuma |
| `dms:message:manage` | Doğrudan mesaj gönderme ve yönetme |
| `dms:channel:manage` | DM kanalları oluşturma ve yönetme |
| `support_chat:read` | Destek sohbetlerini okuma |
| `support_chat:message:create` | Destek sohbeti mesajları gönderme |
| `company:balance:read` | Bir hesabın bakiyesini okuma |

API sabit bir liste yayınlamaz, bu nedenle bunu eksiksiz liste olarak değil, belgelenmiş küme olarak değerlendirin. Kesin sınır her zaman token'ı oluşturan kimlik bilgisinin kendi izinleridir.

## Hesap erişim token'ları

Bir hesap erişim token'ı, herhangi bir kullanıcıya bağlı olmadan hesabın kendisi olarak işlem yapar. Yalnızca `account_id` ve izin verilecek `scoped_actions` değerlerini ileterek `POST /api/v1/access_tokens` ile bir tane oluşturun. Süresi, hesap kapsamlı bir kullanıcı token'ıyla aynı takvime göre dolar.

Bir istemcinin, örneğin gömülü bir bileşenin, kısa bir süre için hesabınızın erişimine ihtiyaç duyduğu ve belirli bir kullanıcının söz konusu olmadığı durumlarda kullanın. Bildirim veya tercih uç noktaları gibi kullanıcı olarak işlem yapan uç noktalar bunu reddeder.

## `iframe` kullanıcı token'ları

Uygulamanız Whop içinde görüntülendiğinde, aynı kaynaktan gelen her istek `x-whop-user-token` başlığında kısa ömürlü bir JWT taşır. Kimin istekte bulunduğunu öğrenmek için imzasını doğrularsınız, ardından neyi görebileceklerini kontrol edersiniz. Python ve Ruby SDK'ları bunun için bir yardımcı içerir. TypeScript SDK'sı içermez, bu nedenle JWT'yi kendiniz doğrulayın.

Bunu asla siz oluşturmazsınız. Whop gönderir, siz doğrularsınız. Bkz. [Kimlik doğrulama](https://docs.whop.com/tr/developer/guides/authentication.md).

## OAuth token'ları

Bir OAuth token'ı, Whop'ta oturum açmış ve uygulamanızı bir dizi kapsam için onaylamış bir kullanıcıyı temsil eder. Bir API anahtarının aksine, erişimi o kullanıcının yapabilecekleriyle sınırlıdır.

Bunu Whop ile Oturum Açma için ve bir kullanıcının kendi hesabı üzerinde onun adına işlem yapmak için kullanın. Bkz. [OAuth](https://docs.whop.com/tr/developer/guides/oauth.md).

## Kapsam belirleme kontrol listesi

Bir kimlik bilgisi üretime ulaşmadan önce:

* Oluşturulan her token'da açık `scoped_actions` iletin. Asla devralmaya güvenmeyin.
* Hangi uç noktaları çağırdığınızı öğrendikten sonra API anahtarlarını Admin'de bırakmak yerine onlara özel bir izin kümesi verin.
* API anahtarlarını sunucu tarafında tutun. İstemcide yalnızca kullanıcı token'ları bulunmalıdır.
* Uzun ömürlü token'ları önbelleğe almak yerine ihtiyaç duyulduğunda kısa ömürlü token'lar oluşturun.
* Her ortam için ayrı kimlik bilgileri kullanın ve para hareketi yaratan herhangi bir şeyi çalıştırmadan önce hangisini kullandığınızı kontrol edin.

## Sonraki adımlar

> [card] [Hızlı başlangıç](https://docs.whop.com/tr/developer/quickstart.md)
>
> Bir sandbox anahtarı oluşturun ve ilk çağrınızı yapın.

> [card] [Temel Kavramlar](https://docs.whop.com/tr/developer/concepts.md)
>
> Hesapların, kullanıcıların ve izinlerin birbiriyle ilişkisi.

> [card] [OAuth](https://docs.whop.com/tr/developer/guides/oauth.md)
>
> Eksiksiz OAuth 2.1 ve PKCE akışı.

> [card] [Sandbox'ta test edin](https://docs.whop.com/tr/developer/guides/sandbox.md)
>
> Kimlik bilgilerini önce test verileri üzerinde deneyin.


## Related topics

- [Kullanıcı Kimliklerini KYC ile Doğrulayın](https://docs.whop.com/tr/developer/verification/overview.md)
- [Sohbet Kimlik Doğrulaması](https://docs.whop.com/tr/developer/guides/chat/authentication.md)
- [Whop API temel kavramları](https://docs.whop.com/tr/developer/concepts.md)
