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

# Geplande runs

> Voer de code van je gehoste app uit op een cron, één keer per slot of één keer voor elke installatie.

Een geplande run roept je gehoste app aan op een cron in plaats van als reactie op een verzoek. Gebruik er een voor werk dat door geen enkel Whop-event wordt getriggerd, zoals elke 15 minuten nieuwe bestellingen ophalen uit een ander systeem of 's nachts uitbetalingen reconciliëren.

## Een schema instellen

Een app heeft twee schema's. Stel een van beide of allebei in met [Update app](https://docs.whop.com/nl/api-reference/apps/update-app.md):

```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 * * * *"
  }'
```

| Veld | Wordt uitgevoerd |
| - | - |
| `schedule` | Eén keer per slot, voor de app als geheel. |
| `per_install_schedule` | Eén keer per slot voor elk account waarop de app is geïnstalleerd. Elke run bevat die installatie. Kan niet vaker dan elke 15 minuten worden uitgevoerd. |

Beide accepteren een cron-expressie met vijf velden, gelezen in UTC, van maximaal 64 tekens. De expressie moet minstens één keer afgaan. `schedule` heeft geen minimuminterval. Stuur `null` of een lege string om een schema te wissen. Een ongeldige expressie geeft een `400` terug. De sleutel heeft `developer:update_app` nodig op het account dat eigenaar is van de app.

## De run afhandelen

Exporteer `scheduled()` naast `fetch()` in de server-entry van je build:

```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` vertelt welke run dit is:

| Prop | Waarde |
| - | - |
| `kind` | `global` voor een `schedule`-run, `install` voor een `per_install_schedule`-run. |
| `app_installation` | De installatie, als het object [app installation](https://docs.whop.com/nl/api-reference/app-installations/app-installation). `null` bij een `global`-run. |
| `run_id` | ID van de run voor dit slot. De runs van alle installaties in hetzelfde slot delen deze. |
| `scheduled_at` | Het slot waarvoor de run is, als ISO 8601-timestamp. |
| `attempt` | `1` bij de eerste poging, `2` bij de herhaalpoging. |

`controller.cron` is de expressie die de run heeft ingepland, en `controller.scheduledTime` is het slot in milliseconden sinds de epoch.

Een run gebruikt dezelfde isolate als je request-handlers, dus secrets en de [geïnjecteerde API-sleutel](https://docs.whop.com/nl/developer/websites/hosting.md#call-the-whop-api) werken op dezelfde manier. Een run kan tot 15 minuten duren, terwijl een request-handler 30 seconden krijgt.

> [!TIP]
>
> Bewaar per installatie een sync-cursor in de `metadata` van de installatie, zoals beschreven in [App-installaties](https://docs.whop.com/nl/developer/guides/app-installations.md). Elke run leest deze uit `ctx.props.app_installation.metadata` en schrijft de nieuwe waarde terug wanneer de run klaar is.

## Herhaalpogingen en herhaalde runs

Als een run mislukt, probeert Whop het één keer opnieuw, een minuut later, en laat de run daarna vallen. Roep `controller.noRetry()` aan voordat je een fout gooit om de herhaalpoging over te slaan. Bij de herhaalpoging is `attempt` `2` en is `scheduled_at` nog steeds het oorspronkelijke slot.

Hetzelfde slot kan je app meer dan eens bereiken, en een herhaalpoging kan starten terwijl de run van het volgende slot al bezig is. Als je werk niet twee keer mag gebeuren, registreer dan elke voltooide run onder `run_id` plus `app_installation.id` en sla een run over die je al hebt geregistreerd.

## Overgeslagen slots

Er vindt geen run plaats zolang de app geen productie-webbuild met een server-entry heeft. Whop zet een overgeslagen slot niet in de wachtrij en haalt het later ook niet in, dus bouw elke run zo dat die verdergaat vanaf wat de vorige heeft opgeslagen.

## Logs

De `console`-output en niet-afgevangen fouten van een run verschijnen in de [logs](https://docs.whop.com/nl/developer/websites/hosting.md#logs) van je app, naast de verzoeken.

## Volgende stappen

> [card] [App-installaties](https://docs.whop.com/nl/developer/guides/app-installations.md)
>
> De installatie die elke run per installatie bevat, en waar je een sync-cursor bewaart.

> [card] [Hosting](https://docs.whop.com/nl/developer/websites/hosting.md)
>
> Builds, secrets, de geïnjecteerde API-sleutel en logs.


## Related topics

- [Websitehosting op Whop](https://docs.whop.com/nl/developer/websites/hosting.md)
- [Update Recommendation](https://docs.whop.com/nl/api-reference/economic-intelligence/update-recommendation.md)
- [Deploy App](https://docs.whop.com/nl/api-reference/apps/deploy-app.md)
