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

# Idempotent istekler

> POST isteklerini bir idempotency anahtarıyla yeniden deneyin; böylece bir istek asla iki kez yürütülmez.

Current API'deki kimliği doğrulanmış her `POST`, bir `Idempotency-Key` başlığı kabul eder. Anahtar içeren bir istek başarılı olduğunda, yanıtı 24 saat boyunca saklanır. Aynı anahtarla yeniden denemek, isteği tekrar yürütmek yerine saklanan yanıtı yeniden oynatır. Bu, sizin tarafınızda zaman aşımına uğrayan veya hata veren bir isteği; yinelenen bir ücretlendirme, transfer veya kaynak riski olmadan güvenle yeniden denemenizi sağlar.

255 bayta kadar herhangi bir benzersiz dize anahtar olarak kullanılabilir; UUID iyi bir varsayılandır. Her farklı işlem için yeni bir anahtar oluşturun ve bu anahtarın aynısını yalnızca o işlemi yeniden denemek için kullanın.

```bash theme={null}
curl -X POST https://api.whop.com/api/v1/transfers \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Idempotency-Key: d9105228-4a08-46b1-8b91-42fed586d383" \
  -H "Content-Type: application/json" \
  -d '{"type": "balance", "amount": "10.00", "currency": "usd", "destination_id": "user_XXXXXXXX"}'
```

| Yeniden denemeniz | Aldığınız |
| - | - |
| Aynı anahtar, aynı istek | Orijinal yanıt, yeniden oynatılmış halde; ikinci bir yürütme değil |
| Aynı anahtar, farklı istek | Bir `400` hatası |
| Aynı anahtar, ilk istek hâlâ çalışırken | Bir `409` hatası; ilk istek bittikten sonra yeniden deneyin |
| Aynı anahtar, 24 saatten daha sonra | Anahtar yeniymiş gibi yeni bir yürütme |

Yeniden oynatılan yanıtlar, durum kodu dahil orijinalle bayt bayt aynıdır ve bir yeniden oynatmayı yeni bir yürütmeden ayırt edebilmeniz için `Idempotent-Replayed: true` başlığı taşır.

> [!NOTE]
>
> **Hata yanıtları da yeniden oynatılır.** Orijinal istek bir `4xx` ile başarısız olduysa, aynı anahtarla yeniden denemek aynı hatayı döndürür. Bu başarısızlık isteğin gerçek sonucuydu; bunun yerine düzeltilmiş istekle birlikte yeni bir anahtar gönderin.

Bilinmesi gereken birkaç ayrıntı:

* "Aynı istek", metot, yol, sorgu dizesi, gövde ve `Api-Version-Date` değerlerinin tamamının orijinalle tam olarak eşleşmesi anlamına gelir. Herhangi bir fark, anahtarın yeniden kullanımı olarak değerlendirilir ve `error.code` değeri `idempotency_key_mismatch` olan bir `400` ile reddedilir.
* Anahtarlar, kimliği doğrulanmış çağırana göre kapsamlandırılır. İki farklı API anahtarı veya kullanıcı, çakışma olmadan aynı anahtar değerini kullanabilir.
* Başlık, kimliği doğrulanmamış isteklerde ve `POST` dışındaki metotlarda yok sayılır; `GET`, `PATCH` ve `DELETE` istekleri güvenle yeniden denenebilir.
* Bir anahtarla yapılan ilk istek hâlâ çalışırken, bir yeniden deneme `error.code` değeri `idempotency_request_in_progress` olan bir `409` döndürür. İlk istek bilinmeyen bir sonuçla başarısız olduysa (örneğin, istek ortasında bir sunucu çökmesi), yeniden denemeler anahtarın süresi dolana kadar bu `409` değerini döndürmeye devam eder. API bir isteği asla iki kez yürütme riskine girmez.


## Related topics

- [Whop Entegrasyonlarında Sorun Giderme](https://docs.whop.com/tr/developer/troubleshooting.md)
- [React Native ile Whop uygulamaları oluşturun](https://docs.whop.com/tr/developer/guides/react-native.md)
- [Whop CLI Komutları](https://docs.whop.com/tr/cli/commands.md)
