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

# Whop'ta Web Sitesi Barındırma

> Whop'un web sitenizi yüklediğiniz derlemeden nasıl çalıştırdığı; yapılandırılacak bir sunucu yoktur.

Whop sitenizi doğrudan yüklediğiniz derlemeden sunar. Yapılandırılacak bir sunucu ve hedef gösterilecek bir dağıtım hedefi yoktur.

## Derlemeler ve sürümler

Her dağıtım bir derleme üretir ve aynı anda tam olarak biri production'dadır.

```bash theme={null}
whop apps deploy                            # build, upload, promote
whop apps deploy --preview                  # upload only
whop apps builds promote abld_xxxxxxxx      # make a build live
```

Daha eski bir derlemeyi yükseltmek geri almanın kendisidir; ayrı bir geri döndürme komutu yoktur. Kontrol panelinde **Versions** sekmesini kullanın.

Vite eklentisi derlemenizi yüklenen arşive paketler: `dist/client` içindeki varlıklar doğrudan sunulur ve `dist/server` sunucu kodunuzu çalıştırır.

## Gizli anahtarlar

Uygulama gizli anahtarları, çalışma zamanında ortam değişkenlerine dönüşen şifrelenmiş bağlamalardır.

```bash theme={null}
whop apps secrets list
whop apps secrets set --secret MAIL_API_KEY=mail-key-123
whop apps secrets unset --key MAIL_API_KEY
```

Bunları bağlı bir proje içinde çalıştırın veya `--app app_xxxxxxxx` iletin. `whop apps dev`, yerel çalışma zamanını kontrol eden adlar dışında aynı gizli anahtarları yerel olarak enjekte eder. Kendiniz dışa aktardığınız bir ortam değişkeni her zaman önceliklidir.

Çalışma zamanı ayrıca şunları ayarlar:

| Bağlama | Amaç |
| - | - |
| `APP_ID` | Sunulan uygulama |
| `BUILD_ID` | Şu anda yükseltilmiş olan derleme |
| `WHOP_API_ORIGIN` | İsteklerin oluşturulacağı Whop API kaynağı |
| `WHOP_ACCOUNT_ID` | API okumalarını kendi kataloğunuzla sınırlamak için uygulamanın sahibi olan hesabın `biz_` kimliği |
| `ASSETS` | Statik varlıklarınızı sunar |
| `REALTIME` | Gerçek zamanlı bağlantıları destekler |

> [!NOTE]
>
> Bu adlar ayrılmıştır; aynı ada sahip bir gizli anahtar yok sayılır.

## Whop API'sini çağırın

Sunucu tarafı `fetch` çağrıları, Whop API isteklerine uygulamanın API anahtarını ekleyen bir giden proxy'den geçer:

```typescript src/routes/api.account.ts theme={null}
const response = await fetch(`${process.env.WHOP_API_ORIGIN}/api/v1/accounts/me`);
const account = await response.json();
```

Anahtar hiçbir zaman kodunuza ulaşmaz; bu nedenle okunamaz, günlüğe kaydedilemez veya pakete eklenemez. Başka yerlere giden istekler dokunulmadan geçer.

* **Yalnızca sunucu tarafı çağrılar imzalanır.** Bir tarayıcı `fetch` çağrısı sunucunuzdan değil, ziyaretçinin makinesinden çıkar; bunları kendi işleyiciniz üzerinden yönlendirin.
* Bir sunucu tarafı isteği kimlik doğrulamasız bırakmak için **`x-whop-inject-key: none` gönderin**.

> [!WARNING]
>
> Enjekte edilen anahtar uygulamanın kendi işletmesine aittir ve para taşıyamaz. Ödeme ve transfer **okumalarına** izin verilir. Para çekme, transfer gönderme ve ödeme hedeflerini yönetme izinleri verilmez; bu nedenle bunlar siz kendi anahtarınızı sağlayana kadar bir kapsam hatası döndürür. Ayrıca ziyaretçi olarak değil, her zaman işletmeniz olarak kimlik doğrular; ziyaretçi kimliği için [OAuth](https://docs.whop.com/tr/developer/guides/oauth.md) kullanın.

## Zamanlanmış çalıştırmalar

Barındırılan bir uygulama, herhangi bir istek olmadan bir cron üzerinde de çalışabilir: uygulamada `schedule` veya `per_install_schedule` ayarlayın ve `fetch()` yanında `scheduled()` dışa aktarın. Bkz. [Zamanlanmış çalıştırmalar](https://docs.whop.com/tr/developer/guides/scheduled-runs.md).

## Günlükler

Çalışma zamanı her `console.log`, yakalanmamış istisna ve başarısız isteği 7 gün boyunca kaydeder.

```bash theme={null}
whop apps logs app_xxxxxxxx
whop apps logs app_xxxxxxxx --level error
whop apps logs app_xxxxxxxx --query "checkout"
```

Bir zaman aralığı seçmek için ISO 8601 zaman damgalarıyla `--created_after` ve `--created_before` kullanın. İstemci tarafı JavaScript hataları burada değildir; bunlar ziyaretçinin tarayıcı konsolundadır.

## Sonraki adımlar

> [card] [Ziyaretçileri izleyin](https://docs.whop.com/tr/developer/websites/tracking.md)
>
> Piksel zaten yüklü; kendi olaylarınızı ekleyin.

> [card] [Blueprint'ler](https://docs.whop.com/tr/developer/websites/blueprints.md)
>
> Boş bir proje yerine çalışan bir işletmeden başlayın.

> [card] [Ödeme alın](https://docs.whop.com/tr/developer/guides/accept-payments.md)
>
> Doğrudan barındırdığınız siteden satış yapın.

> [card] [CLI referansı](https://docs.whop.com/tr/developer/cli.md)
>
> Tüm `whop apps` komutları.


## Related topics

- [Whop'ta Bir Web Sitesi Barındırın](https://docs.whop.com/tr/developer/websites/overview.md)
- [CLI ile Bir Web Sitesi Oluşturun](https://docs.whop.com/tr/developer/websites/quickstart.md)
- [Sandbox'ta Test Edin](https://docs.whop.com/tr/developer/guides/sandbox.md)
