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

> Prøv enhver skriveoperasjon trygt på nytt, uten å opprette noe to ganger

## Skriveoperasjoner som endrer en eksisterende ressurs

Ingen header er involvert. Der en gjentakelse tidligere returnerte en feil, returnerer den nå gjeldende tilstand:

| Endepunkt | Et gjentatt kall returnerer |
| - | - |
| [Kanseller time](https://docs.anivahealth.com/no/api/appointments/cancel-appointment.md) | `200` med den kansellerte timen |
| [Kanseller forsendelse](https://docs.anivahealth.com/no/api/shipments/cancel-shipment.md) | `200` med den kansellerte forsendelsen |
| [Kanseller bestilling av hjemmetestsett](https://docs.anivahealth.com/no/api/home-kit-orders/cancel-home-kit.md) | `200` med den kansellerte bestillingen |
| [Aktiver bestilling av hjemmetestsett](https://docs.anivahealth.com/no/api/home-kit-orders/activate-home-kit.md) | `200`, hvis prøvetakingstidspunktet er det samme |
| Fjerning av paneler eller biomarkører | `200`, uansett om de fortsatt var tilknyttet eller ikke |

En gjentakelse skriver ingenting, og svaret inneholder `Idempotent-Replayed: true` — denne headeren lar deg skille mellom «jeg kansellerte den» og «den var allerede kansellert».

Tre unntak returnerer `409` i stedet:

* **Aktivering med et *annet* `activated_at`.** Prøvetakingstidspunktet står i laboratorierapporten, så et nytt forsøk må ikke overskrive det i stillhet.
* **Kansellering av en allerede kansellert time med en *annen* `cancellation_reason`.** Samme logikk: den registrerte årsaken kan ha blitt rettet i ettertid, og et nytt forsøk må ikke overskrive den. Send den registrerte årsaken på nytt, eller utelat den.
* **Kansellering når det ikke lenger kan gjøres om** — en bekreftet blodprøvetaking, en hentet forsendelse, et sendt eller aktivert sett.

Tre endepunkter er bevisst ikke trygge å prøve på nytt:

* [Bekreft blodprøvetaking](https://docs.anivahealth.com/no/api/appointments/confirm-blood-draw.md) — kall nummer to returnerer `409`.
* [Send resultater på e-post](https://docs.anivahealth.com/no/api/appointments/email-results.md) (`POST /v1/appointments/{id}/results/email`) og [Send resultater på e-post](https://docs.anivahealth.com/no/api/home-kit-orders/email-results.md) (`POST /v1/home-kit-orders/{id}/results/email`) — hvert kall sender én e-post. Et nytt forsøk etter et tidsavbrudd eller en `5xx` kan sende kunden et duplikat.

## Skriveoperasjoner som oppretter noe

Fem endepunkter godtar en valgfri `Idempotency-Key`-header på maksimalt 255 tegn:

* [Opprett profil](https://docs.anivahealth.com/no/api/profiles/create-profile.md)
* [Opprett time](https://docs.anivahealth.com/no/api/appointments/create-appointment.md)
* [Opprett bestilling av hjemmetestsett](https://docs.anivahealth.com/no/api/home-kit-orders/create-home-kit.md)
* [Opprett forsendelse](https://docs.anivahealth.com/no/api/shipments/create-shipment.md)
* [Last opp dokument](https://docs.anivahealth.com/no/api/documents/upload-document.md)

Én nøkkel, fire forsøk, én bestilling — hva du får tilbake avhenger av når du prøver på nytt og om innholdet samsvarer:

![Sekvensdiagram: et duplikat som sendes 350 ms etter den første forespørselen får 409 mens den første fortsatt kjører, den første returnerer 201, et senere nytt forsøk med samme nøkkel returnerer den samme bestillingen merket Idempotent-Replayed, og samme nøkkel med endret innhold returnerer 409.](https://mintcdn.com/anivahealth/8KTut54iIoaIFYY2/images/idempotency-retry.svg?fit=max\&auto=format\&n=8KTut54iIoaIFYY2\&q=85\&s=617f6b19f473ee0fed9243004f932c19)

Nøkler er begrenset til API-nøkkelen din **og** til endepunktet, så de kolliderer aldri med en annen partners nøkler eller med samme nøkkel brukt et annet sted.

* **Samme nøkkel, samme innhold** → i 24 timer får du det opprinnelige svaret tilbake, merket `Idempotent-Replayed: true`. Rekkefølgen på feltene og blanktegn har ingen betydning.
* **Samme nøkkel, annet innhold** → `409`.
* **En tom `Idempotency-Key`** → `400`, i stedet for å bli ignorert.

### Når nøkkelen frigis

Opprettelse er **ikke atomær** — en `5xx` betyr ikke at ingenting ble skrevet.

* **Forespørselen feilet før noe ble opprettet** → nøkkelen frigis, så du kan prøve på nytt med den.
* **Forespørselen feilet etter at noe ble opprettet**, eller **returnerte aldri** → nøkkelen forblir opptatt, og nye forsøk får `409`. Hent ressursen for å sjekke om den finnes, og bruk deretter en ny nøkkel hvis den ikke gjør det.

> [!NOTE]
>
> En gjentakelse returnerer svarinnholdet som ble registrert da ressursen ble opprettet — et øyeblikksbilde, ikke en
> sanntidslesing. Hvis ressursen har endret seg siden da, henter du den direkte.

### Noen opprettelser har også en naturlig nøkkel

To endepunkter avviser duplikater på egen hånd, uavhengig av eventuell header:

* [Opprett time](https://docs.anivahealth.com/no/api/appointments/create-appointment.md) tillater én time per profil, lokasjon og tidspunkt. En gjentakelse returnerer `409` med eksisterende `appointment_id`.
* [Opprett profil](https://docs.anivahealth.com/no/api/profiles/create-profile.md) returnerer `409` når `email` allerede har en profil. Utelater du `email`, genereres en unik plassholder per forespørsel, så gjentakelser oppretter *faktisk* separate profiler.

Når begge gjelder, er det `409` fra den naturlige nøkkelen du får, og bare den inneholder ekstrafeltet (`appointment_id`, eller en `error_name`-diskriminator) — en `409` fra idempotens inneholder bare `error`, så les disse feltene defensivt.


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