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

# Zamanlanmış Çalıştırmalar

> Barındırılan uygulamanızın kodunu bir cron ile, her zaman dilimi için bir kez veya her kurulum için bir kez çalıştırın.

Zamanlanmış bir çalıştırma, barındırılan uygulamanızı bir isteğe yanıt olarak değil, bir cron ile çağırır. Bunu, hiçbir Whop olayının tetiklemediği işler için kullanın; örneğin her 15 dakikada bir başka bir sistemden yeni siparişleri çekmek veya para çekmelerin mutabakatını gece boyunca yapmak.

## Bir zamanlama ayarlayın

Bir uygulamanın iki zamanlaması vardır. Birini veya ikisini [Uygulamayı güncelle](https://docs.whop.com/tr/api-reference/apps/update-app.md) ile ayarlayın:

```bash theme={null}
curl -X PATCH "https://api.whop.com/api/v1/apps/app_XXXXXXXX" \
  -H "Authorization: Bearer $WHOP_DEVELOPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "schedule": "0 3 * * *",
    "per_install_schedule": "*/15 * * * *"
  }'
```

| Alan | Çalışma şekli |
| - | - |
| `schedule` | Uygulamanın bütünü için, her zaman diliminde bir kez. |
| `per_install_schedule` | Uygulamayı yüklemiş her hesap için, her zaman diliminde bir kez. Her çalıştırma ilgili kurulumu taşır. 15 dakikada birden daha sık tetiklenemez. |

Her ikisi de UTC olarak okunan, en fazla 64 karakterlik beş alanlı bir cron ifadesi alır. İfadenin en az bir kez tetiklenmesi gerekir. `schedule` için minimum aralık yoktur. Bir zamanlamayı temizlemek için `null` veya boş bir dize gönderin. Geçersiz bir ifade `400` döndürür. Anahtarın, uygulamanın sahibi olan hesapta `developer:update_app` iznine sahip olması gerekir.

## Çalıştırmayı ele alın

Derlemenizin sunucu giriş noktasında `fetch()` fonksiyonunun yanına `scheduled()` fonksiyonunu dışa aktarın:

```typescript src/server.ts theme={null}
export default {
  async fetch(request, env, ctx) {
    /* ... */
  },

  async scheduled(controller, env, ctx) {
    const { kind, app_installation } = ctx.props;

    if (kind === "global") {
      await reconcilePayouts();
      return;
    }

    await syncOrders(app_installation.external_id, app_installation.metadata.orders_cursor);
  },
};
```

`ctx.props` bunun hangi çalıştırma olduğunu belirtir:

| Prop | Değer |
| - | - |
| `kind` | Bir `schedule` çalıştırması için `global`, bir `per_install_schedule` çalıştırması için `install`. |
| `app_installation` | [Uygulama kurulumu](https://docs.whop.com/tr/api-reference/app-installations/app-installation) nesnesi olarak kurulum. `global` çalıştırmada `null`. |
| `run_id` | Bu zaman diliminin çalıştırmasının kimliği. Aynı zaman dilimindeki her kurulumun çalıştırması bunu paylaşır. |
| `scheduled_at` | Çalıştırmanın ait olduğu zaman dilimi, ISO 8601 zaman damgası olarak. |
| `attempt` | İlk denemede `1`, yeniden denemede `2`. |

`controller.cron` çalıştırmayı zamanlayan ifadedir; `controller.scheduledTime` ise epoch'tan bu yana milisaniye cinsinden zaman dilimidir.

Bir çalıştırma, istek işleyicilerinizle aynı izolatı kullanır; bu nedenle gizli anahtarlar ve [enjekte edilen API anahtarı](https://docs.whop.com/tr/developer/websites/hosting.md#call-the-whop-api) aynı şekilde çalışır. Bir istek işleyicisi 30 saniye alırken, bir çalıştırma 15 dakikaya kadar sürebilir.

> [!TIP]
>
> [Uygulama kurulumları](https://docs.whop.com/tr/developer/guides/app-installations.md) sayfasında açıklandığı gibi, kurulum başına bir senkronizasyon imlecini kurulumun `metadata` alanında tutun. Her çalıştırma bunu `ctx.props.app_installation.metadata` üzerinden okur ve bittiğinde yeni değeri geri yazar.

## Yeniden denemeler ve tekrarlanan çalıştırmalar

Bir çalıştırma başarısız olursa Whop bunu bir dakika sonra bir kez yeniden dener, ardından bırakır. Yeniden denemeyi atlamak için hata fırlatmadan önce `controller.noRetry()` çağırın. Yeniden denemede `attempt` değeri `2` olur ve `scheduled_at` hâlâ orijinal zaman dilimidir.

Aynı zaman dilimi uygulamanıza birden fazla kez ulaşabilir ve bir yeniden deneme, bir sonraki zaman diliminin çalıştırması zaten devam ederken başlayabilir. İşinizin iki kez gerçekleşmemesi gerekiyorsa, tamamladığınız her çalıştırmayı `run_id` ve `app_installation.id` altında kaydedin ve zaten kaydettiğiniz bir çalıştırmayı atlayın.

## Atlanan zaman dilimleri

Uygulamanın sunucu giriş noktasına sahip bir üretim web derlemesi yokken hiçbir çalıştırma gerçekleşmez. Whop, atladığı bir zaman dilimini kuyruğa almaz veya daha sonra telafi etmez; bu nedenle her çalıştırmayı, bir öncekinin kaydettiği yerden devam edecek şekilde oluşturun.

## Günlükler

Bir çalıştırmanın `console` çıktısı ve yakalanmamış hataları, uygulamanızın [günlüklerinde](https://docs.whop.com/tr/developer/websites/hosting.md#logs) isteklerinin yanında görünür.

## Sonraki adımlar

> [card] [Uygulama kurulumları](https://docs.whop.com/tr/developer/guides/app-installations.md)
>
> Kurulum başına her çalıştırmanın taşıdığı kurulum ve bir senkronizasyon imlecinin nerede tutulacağı.

> [card] [Barındırma](https://docs.whop.com/tr/developer/websites/hosting.md)
>
> Derlemeler, gizli anahtarlar, enjekte edilen API anahtarı ve günlükler.


## Related topics

- [Whop'ta Web Sitesi Barındırma](https://docs.whop.com/tr/developer/websites/hosting.md)
- [Alt Hesaplar İçin Ödeme Tahsil Edin](https://docs.whop.com/tr/developer/platforms/collect-payments-for-subaccounts.md)
- [AI Sohbeti](https://docs.whop.com/tr/api-reference/legacy/ai-chats/ai-chat.md)
