> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Idempotens

> Gentag enhver skrivning sikkert uden at oprette noget to gange

## Skrivekald, der ændrer en eksisterende ressource

Ingen header er involveret. Hvor en gentagelse tidligere returnerede en fejl, returnerer den nu den aktuelle tilstand:

| Endpoint | Et gentaget kald returnerer |
| - | - |
| [Annuller tid](https://docs.anivahealth.com/da/api/appointments/cancel-appointment.md) | `200` med den annullerede tid |
| [Annuller forsendelse](https://docs.anivahealth.com/da/api/shipments/cancel-shipment.md) | `200` med den annullerede forsendelse |
| [Annuller hjemmetestkitordre](https://docs.anivahealth.com/da/api/home-kit-orders/cancel-home-kit.md) | `200` med den annullerede ordre |
| [Aktiver hjemmetestkitordre](https://docs.anivahealth.com/da/api/home-kit-orders/activate-home-kit.md) | `200`, hvis prøvetagningstidspunktet er det samme |
| Fjernelse af paneler eller biomarkører | `200`, uanset om de stadig var tilknyttet eller ej |

En gentagelse skriver intet, og dens svar har `Idempotent-Replayed: true` — med den header kan du skelne mellem "jeg annullerede den" og "den var allerede annulleret".

Tre undtagelser returnerer `409` i stedet:

* **Aktivering med en *anden* `activated_at`.** Prøvetagningstidspunktet fremgår af laboratorierapporten, så et nyt forsøg må ikke overskrive det i stilhed.
* **Annullering af en allerede annulleret tid med en *anden* `cancellation_reason`.** Samme begrundelse: Den registrerede årsag kan siden være blevet rettet, og et nyt forsøg må ikke overskrive den. Send den registrerede årsag igen, eller udelad den.
* **Annullering, når det er for sent** — en bekræftet blodprøvetagning, en afhentet forsendelse, et afsendt eller aktiveret kit.

Tre endpoints er bevidst ikke sikre ved gentagne forsøg:

* [Bekræft blodprøvetagning](https://docs.anivahealth.com/da/api/appointments/confirm-blood-draw.md) — et andet kald returnerer `409`.
* [Send resultater på e-mail](https://docs.anivahealth.com/da/api/appointments/email-results.md) (`POST /v1/appointments/{id}/results/email`) og [Send resultater på e-mail](https://docs.anivahealth.com/da/api/home-kit-orders/email-results.md) (`POST /v1/home-kit-orders/{id}/results/email`) — hvert kald sender én e-mail. Et nyt forsøg efter en timeout eller en `5xx` kan sende en dublet til kunden.

## Skrivekald, der opretter noget

Fem endpoints accepterer en valgfri `Idempotency-Key`-header på højst 255 tegn:

* [Opret profil](https://docs.anivahealth.com/da/api/profiles/create-profile.md)
* [Opret tid](https://docs.anivahealth.com/da/api/appointments/create-appointment.md)
* [Opret hjemmetestkitordre](https://docs.anivahealth.com/da/api/home-kit-orders/create-home-kit.md)
* [Opret forsendelse](https://docs.anivahealth.com/da/api/shipments/create-shipment.md)
* [Upload dokument](https://docs.anivahealth.com/da/api/documents/upload-document.md)

Én nøgle, fire forsøg, én ordre — hvad du får tilbage, afhænger af, hvornår du prøver igen, og om body matcher:

![Sekvensdiagram: En dublet sendt 350 ms efter den første forespørgsel får 409, mens den første stadig kører, den første returnerer 201, et senere forsøg med samme nøgle returnerer samme ordre markeret med Idempotent-Replayed, og samme nøgle med en ændret body returnerer 409.](https://mintcdn.com/anivahealth/8KTut54iIoaIFYY2/images/idempotency-retry.svg?fit=max\&auto=format\&n=8KTut54iIoaIFYY2\&q=85\&s=617f6b19f473ee0fed9243004f932c19)

Nøgler er knyttet til din API-nøgle **og** til endpointet, så de aldrig kolliderer med en anden partners eller med samme nøgle brugt et andet sted.

* **Samme nøgle, samme body** → i 24 timer får du det oprindelige svar tilbage, markeret med `Idempotent-Replayed: true`. Feltrækkefølge og whitespace har ingen betydning.
* **Samme nøgle, anden body** → `409`.
* **En tom `Idempotency-Key`** → `400` i stedet for at blive ignoreret.

### Hvornår nøglen frigives

Oprettelse er **ikke atomisk** — en `5xx` betyder ikke, at der ikke blev skrevet noget.

* **Forespørgslen fejlede, før noget blev oprettet** → nøglen frigives, så du kan prøve igen med den.
* **Forespørgslen fejlede, efter noget var oprettet**, eller **returnerede aldrig et svar** → nøglen forbliver optaget, og nye forsøg får `409`. Hent ressourcen for at tjekke, om den findes, og brug derefter en ny nøgle, hvis den ikke gør.

> [!NOTE]
>
> En gentagelse returnerer den response-body, der blev gemt, da ressourcen blev oprettet — et øjebliksbillede,
> ikke et live-opslag. Hvis ressourcen er ændret siden, skal du hente den direkte.

### Nogle oprettelser har også en naturlig nøgle

To endpoints afviser dubletter af sig selv, uafhængigt af nogen header:

* [Opret tid](https://docs.anivahealth.com/da/api/appointments/create-appointment.md) tillader én tid pr. profil, lokation og tidspunkt. En gentagelse returnerer `409` med det eksisterende `appointment_id`.
* [Opret profil](https://docs.anivahealth.com/da/api/profiles/create-profile.md) returnerer `409`, når `email` allerede har en profil. Udelader du `email`, genereres en unik pladsholder pr. forespørgsel, så gentagelser *faktisk* opretter separate profiler.

Når begge gør sig gældende, er det `409` fra den naturlige nøgle, du ser, og kun den indeholder ekstrafeltet (`appointment_id` eller en `error_name`-diskriminator) — en `409` fra idempotens indeholder kun `error`, så læs disse felter defensivt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.