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

# Idempotenssi

> Yritä mitä tahansa kirjoitusta uudelleen turvallisesti luomatta mitään kahdesti

## Olemassa olevaa resurssia muuttavat kirjoitukset

Otsikkokenttää ei tarvita. Siinä missä toisto aiemmin palautti virheen, se palauttaa nyt nykyisen tilan:

| Päätepiste | Toistettu kutsu palauttaa |
| - | - |
| [Peru ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/cancel-appointment.md) | `200` ja perutun ajanvarauksen |
| [Peru lähetys](https://docs.anivahealth.com/fi/api/shipments/cancel-shipment.md) | `200` ja perutun lähetyksen |
| [Peru kotitestipakkaustilaus](https://docs.anivahealth.com/fi/api/home-kit-orders/cancel-home-kit.md) | `200` ja perutun tilauksen |
| [Aktivoi kotitestipakkaustilaus](https://docs.anivahealth.com/fi/api/home-kit-orders/activate-home-kit.md) | `200`, jos näytteenottoaika on sama |
| Paneelien tai biomarkkerien poistaminen | `200`, riippumatta siitä, olivatko ne enää liitettyinä |

Toisto ei kirjoita mitään, ja sen vastauksessa on `Idempotent-Replayed: true` — tämän otsikkokentän avulla erotat, peruitko sen itse vai oliko se jo peruttu.

Kolme poikkeusta palauttaa sen sijaan koodin `409`:

* **Aktivointi *eri* `activated_at`-arvolla.** Näytteenottoaika merkitään laboratorioraporttiin, joten uusintayritys ei saa korvata sitä huomaamatta.
* **Jo perutun ajanvarauksen peruminen *eri* `cancellation_reason`-arvolla.** Sama perustelu: kirjattua syytä on voitu korjata sen jälkeen, eikä uusintayritys saa korvata sitä. Lähetä kirjattu syy uudelleen tai jätä se pois.
* **Peruminen peruuttamattoman vaiheen jälkeen** — vahvistettu verinäytteenotto, noudettu lähetys, lähetetty tai aktivoitu pakkaus.

Kolme päätepistettä ei tarkoituksella ole turvallisia toistaa:

* [Vahvista verinäytteenotto](https://docs.anivahealth.com/fi/api/appointments/confirm-blood-draw.md) — toinen kutsu palauttaa koodin `409`.
* [Lähetä tulokset sähköpostilla](https://docs.anivahealth.com/fi/api/appointments/email-results.md) (`POST /v1/appointments/{id}/results/email`) ja [Lähetä tulokset sähköpostilla](https://docs.anivahealth.com/fi/api/home-kit-orders/email-results.md) (`POST /v1/home-kit-orders/{id}/results/email`) — jokainen kutsu lähettää yhden sähköpostin. Uusintayritys aikakatkaisun tai `5xx`-virheen jälkeen voi lähettää asiakkaalle kaksoiskappaleen.

## Uutta luovat kirjoitukset

Viisi päätepistettä hyväksyy valinnaisen `Idempotency-Key`-otsikkokentän, jonka enimmäispituus on 255 merkkiä:

* [Luo profiili](https://docs.anivahealth.com/fi/api/profiles/create-profile.md)
* [Luo ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/create-appointment.md)
* [Luo kotitestipakkaustilaus](https://docs.anivahealth.com/fi/api/home-kit-orders/create-home-kit.md)
* [Luo lähetys](https://docs.anivahealth.com/fi/api/shipments/create-shipment.md)
* [Lähetä asiakirja](https://docs.anivahealth.com/fi/api/documents/upload-document.md)

Yksi avain, neljä yritystä, yksi tilaus — palautettava vastaus riippuu siitä, milloin yrität uudelleen ja täsmääkö pyynnön runko:

![Sekvenssikaavio: 350 ms ensimmäisen pyynnön jälkeen lähetetty toistettu pyyntö saa vastauksen 409 ensimmäisen pyynnön ollessa yhä käynnissä, ensimmäinen palauttaa koodin 201, myöhempi uusintayritys samalla avaimella palauttaa saman tilauksen merkinnällä Idempotent-Replayed ja sama avain muutetulla rungolla palauttaa koodin 409.](https://mintcdn.com/anivahealth/8KTut54iIoaIFYY2/images/idempotency-retry.svg?fit=max\&auto=format\&n=8KTut54iIoaIFYY2\&q=85\&s=617f6b19f473ee0fed9243004f932c19)

Avaimet rajataan API-avaimeesi **ja** päätepisteeseen, joten ne eivät koskaan törmää toisen kumppanin avaimiin tai samaan avaimeen muualla.

* **Sama avain, sama runko** → saat 24 tunnin ajan takaisin alkuperäisen vastauksen merkinnällä `Idempotent-Replayed: true`. Kenttien järjestyksellä ja tyhjämerkeillä ei ole merkitystä.
* **Sama avain, eri runko** → `409`.
* **Tyhjä `Idempotency-Key`** → `400`, eikä sitä ohiteta.

### Milloin avain vapautetaan

Luonti **ei ole atominen** — `5xx`-virhe ei tarkoita, ettei mitään olisi kirjoitettu.

* **Pyyntö epäonnistui ennen kuin mitään luotiin** → avain vapautetaan, joten voit yrittää uudelleen samalla avaimella.
* **Pyyntö epäonnistui sen jälkeen, kun jotain luotiin**, tai **ei palannut lainkaan** → avain pysyy varattuna ja uusintayritykset saavat koodin `409`. Hae resurssi tarkistaaksesi, onko se olemassa, ja käytä uutta avainta, jos ei ole.

> [!NOTE]
>
> Toisto palauttaa resurssin luontihetkellä tallennetun vastauksen rungon — tilannekuvan, ei
> reaaliaikaista lukua. Jos resurssi on muuttunut sen jälkeen, hae se suoraan.

### Joillakin luontikutsuilla on myös luonnollinen avain

Kaksi päätepistettä hylkää kaksoiskappaleet itse, otsikkokentistä riippumatta:

* [Luo ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/create-appointment.md) sallii yhden ajanvarauksen profiilia, toimipistettä ja ajankohtaa kohden. Toisto palauttaa koodin `409` ja olemassa olevan `appointment_id`-tunnuksen.
* [Luo profiili](https://docs.anivahealth.com/fi/api/profiles/create-profile.md) palauttaa koodin `409`, kun `email`-osoitteella on jo profiili. Jos jätät `email`-kentän pois, jokaiselle pyynnölle luodaan yksilöllinen paikkamerkki, joten toistot *luovat* erilliset profiilit.

Kun molemmat pätevät, saat luonnollisen avaimen `409`-vastauksen, ja vain se sisältää lisäkentän (`appointment_id` tai `error_name`-erottimen) — idempotenssin `409`-vastaus sisältää pelkän `error`-kentän, joten tarkista näiden kenttien olemassaolo ennen lukemista.


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