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

# Idempotente anmodninger

> Prøv POST-anmodninger igen med en idempotensnøgle, så en anmodning aldrig udføres to gange.

Hver autentificeret `POST` på Current API accepterer en `Idempotency-Key`-header. Når en anmodning med en nøgle lykkes, gemmes dens svar i 24 timer. Et nyt forsøg med den samme nøgle afspiller det gemte svar igen i stedet for at udføre anmodningen igen. Det gør det sikkert at prøve en anmodning igen, der fik timeout eller fejlede på din side, uden at risikere en dobbelt opkrævning, overførsel eller ressource.

Enhver unik streng på op til 255 bytes fungerer som nøgle – et UUID er et godt standardvalg. Generér en ny nøgle for hver særskilt handling, og genbrug kun præcis den nøgle til at prøve den handling igen.

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

| Dit nye forsøg | Du får |
| - | - |
| Samme nøgle, samme anmodning | Det oprindelige svar, afspillet igen – ikke en ny udførelse |
| Samme nøgle, anden anmodning | En `400`-fejl |
| Samme nøgle, mens den første anmodning stadig kører | En `409`-fejl – prøv igen, når den første anmodning er færdig |
| Samme nøgle, mere end 24 timer senere | En ny udførelse, som om nøglen var ny |

Genafspillede svar er byte for byte identiske med originalen – inklusive statuskoden – og har en `Idempotent-Replayed: true`-header, så du kan skelne en genafspilning fra en ny udførelse.

> [!NOTE]
>
> **Fejlsvar genafspilles også.** Hvis den oprindelige anmodning fejlede med en `4xx`, returnerer et nyt forsøg med den samme nøgle den samme fejl. Den fejl var anmodningens reelle resultat – send i stedet en ny nøgle med den rettede anmodning.

Et par detaljer, der er værd at kende:

* "Samme anmodning" betyder, at metode, sti, forespørgselsstreng, body og `Api-Version-Date` alle matcher originalen præcist. Enhver forskel behandles som genbrug af nøglen og afvises med en `400`, hvis `error.code` er `idempotency_key_mismatch`.
* Nøgler er afgrænset til den autentificerede kalder. To forskellige API-nøgler eller brugere kan bruge den samme nøgleværdi uden at kollidere.
* Headeren ignoreres på uautentificerede anmodninger og på metoder, der ikke er `POST` – `GET`-, `PATCH`- og `DELETE`-anmodninger er sikre at prøve igen.
* Mens den første anmodning med en nøgle stadig kører, returnerer et nyt forsøg en `409`, hvis `error.code` er `idempotency_request_in_progress`. Hvis den første anmodning fejlede med et ukendt resultat (for eksempel et servernedbrud midt i anmodningen), bliver nye forsøg ved med at returnere den `409`, indtil nøglen udløber. API'et risikerer aldrig at udføre en anmodning to gange.


## Related topics

- [Fejlfinding af Whop-integrationer](https://docs.whop.com/da/developer/troubleshooting.md)
- [Whop API-oversigt](https://docs.whop.com/da/api-reference/overview.md)
- [Whop CLI-kommandoer](https://docs.whop.com/da/cli/commands.md)
