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

# Idempotence

> Droši atkārto jebkuru ierakstīšanas darbību, neko neizveidojot divreiz

## Rakstīšanas darbības, kas maina esošu resursu

Galvene nav nepieciešama. Tur, kur atkārtots pieprasījums agrāk atgrieza kļūdu, tagad tas atgriež pašreizējo stāvokli:

| Galapunkts | Atkārtots izsaukums atgriež |
| - | - |
| [Atcelt pierakstu](https://docs.anivahealth.com/lv/api/appointments/cancel-appointment.md) | `200` ar atcelto pierakstu |
| [Atcelt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/cancel-shipment.md) | `200` ar atcelto sūtījumu |
| [Atcelt mājas testa komplekta pasūtījumu](https://docs.anivahealth.com/lv/api/home-kit-orders/cancel-home-kit.md) | `200` ar atcelto pasūtījumu |
| [Aktivizēt mājas testa komplekta pasūtījumu](https://docs.anivahealth.com/lv/api/home-kit-orders/activate-home-kit.md) | `200`, ja parauga paņemšanas laiks ir tāds pats |
| Paneļu vai biomarķieru noņemšana | `200` neatkarīgi no tā, vai tie vēl bija piesaistīti |

Atkārtots pieprasījums neko neieraksta, un tā atbildē ir iekļauta galvene `Idempotent-Replayed: true` — pēc tās tu vari atšķirt „es to atcēlu” no „tas jau bija atcelts”.

Trīs izņēmumos tā vietā tiek atgriezts `409`:

* **Aktivizēšana ar *citu* `activated_at`.** Parauga paņemšanas laiks tiek iekļauts laboratorijas pārskatā, tāpēc atkārtots mēģinājums to nedrīkst klusām pārrakstīt.
* **Jau atcelta pieraksta atcelšana ar *citu* `cancellation_reason`.** Tas pats pamatojums: ierakstītais iemesls pa šo laiku var būt labots, un atkārtots mēģinājums to nedrīkst pārrakstīt. Nosūti ierakstīto iemeslu vēlreiz vai izlaid to.
* **Atcelšana pēc neatgriezeniska posma** — apstiprinātas asins paņemšanas, savākta sūtījuma, nosūtīta vai aktivizēta komplekta.

Trīs galapunkti apzināti nav droši atkārtotiem mēģinājumiem:

* [Apstiprināt asins paņemšanu](https://docs.anivahealth.com/lv/api/appointments/confirm-blood-draw.md) — otrs izsaukums atgriež `409`.
* [Nosūtīt rezultātus e-pastā](https://docs.anivahealth.com/lv/api/appointments/email-results.md) (`POST /v1/appointments/{id}/results/email`) un [Nosūtīt rezultātus e-pastā](https://docs.anivahealth.com/lv/api/home-kit-orders/email-results.md) (`POST /v1/home-kit-orders/{id}/results/email`) — katrs izsaukums nosūta vienu e-pastu. Atkārtots mēģinājums pēc noildzes vai `5xx` kļūdas var nosūtīt klientam dublikātu.

## Rakstīšanas darbības, kas kaut ko izveido

Pieci galapunkti pieņem neobligātu galveni `Idempotency-Key`, kas ir ne garāka par 255 rakstzīmēm:

* [Izveidot profilu](https://docs.anivahealth.com/lv/api/profiles/create-profile.md)
* [Izveidot pierakstu](https://docs.anivahealth.com/lv/api/appointments/create-appointment.md)
* [Izveidot mājas testa komplekta pasūtījumu](https://docs.anivahealth.com/lv/api/home-kit-orders/create-home-kit.md)
* [Izveidot sūtījumu](https://docs.anivahealth.com/lv/api/shipments/create-shipment.md)
* [Augšupielādēt dokumentu](https://docs.anivahealth.com/lv/api/documents/upload-document.md)

Viena atslēga, četri mēģinājumi, viens pasūtījums — tas, ko saņem atpakaļ, ir atkarīgs no atkārtošanas brīža un no tā, vai pieprasījuma saturs sakrīt:

![Secības diagramma: dublikāts, kas nosūtīts 350 ms pēc pirmā pieprasījuma, saņem 409, kamēr pirmais pieprasījums vēl darbojas; pirmais atgriež 201, vēlāks atkārtots mēģinājums ar to pašu atslēgu atgriež to pašu pasūtījumu ar atzīmi Idempotent-Replayed, bet tā pati atslēga ar mainītu saturu atgriež 409.](https://mintcdn.com/anivahealth/8KTut54iIoaIFYY2/images/idempotency-retry.svg?fit=max\&auto=format\&n=8KTut54iIoaIFYY2\&q=85\&s=617f6b19f473ee0fed9243004f932c19)

Atslēgas ir piesaistītas tavai API atslēgai **un** galapunktam, tāpēc tās nekad nesaduras ar citu partneru atslēgām vai to pašu atslēgu, kas izmantota citur.

* **Tā pati atslēga, tas pats saturs** → 24 stundas tu saņem atpakaļ sākotnējo atbildi ar atzīmi `Idempotent-Replayed: true`. Lauku secībai un atstarpēm nav nozīmes.
* **Tā pati atslēga, cits saturs** → `409`.
* **Tukša galvene `Idempotency-Key`** → `400`, nevis ignorēšana.

### Kad atslēga tiek atbrīvota

Izveide **nav atomāra** — `5xx` nenozīmē, ka nekas netika ierakstīts.

* **Pieprasījums neizdevās, pirms kaut kas tika izveidots** → atslēga tiek atbrīvota, tāpēc vari mēģināt vēlreiz ar to pašu atslēgu.
* **Pieprasījums neizdevās pēc tam, kad kaut kas jau tika izveidots**, vai **vispār neatgrieza atbildi** → atslēga paliek aizņemta, un atkārtoti mēģinājumi saņem `409`. Ielādē resursu, lai pārbaudītu, vai tas eksistē, un, ja tā nav, izmanto jaunu atslēgu.

> [!NOTE]
>
> Atkārtots pieprasījums atgriež atbildes saturu, kas tika saglabāts resursa izveides brīdī —
> momentuzņēmumu, nevis aktuālos datus. Ja resurss kopš tā laika ir mainījies, ielādē to tieši.

### Dažām izveides darbībām ir arī dabiskā atslēga

Divi galapunkti paši noraida dublikātus neatkarīgi no jebkādas galvenes:

* [Izveidot pierakstu](https://docs.anivahealth.com/lv/api/appointments/create-appointment.md) pieļauj vienu pierakstu vienam profilam, vienā atrašanās vietā un vienā laikā. Atkārtots pieprasījums atgriež `409` ar esošo `appointment_id`.
* [Izveidot profilu](https://docs.anivahealth.com/lv/api/profiles/create-profile.md) atgriež `409`, ja `email` jau ir piesaistīts profils. Izlaid `email`, un katram pieprasījumam tiek ģenerēts unikāls vietturis, tāpēc atkārtoti pieprasījumi *tiešām* izveido atsevišķus profilus.

Ja attiecas abi, tu redzi dabiskās atslēgas `409`, un tikai tas satur papildu lauku (`appointment_id` vai `error_name` diskriminatoru) — idempotences `409` satur tikai `error`, tāpēc nolasi šos laukus piesardzīgi.


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