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

# Idempotencia

> Ismételj meg bármilyen írási műveletet biztonságosan, anélkül hogy bármi kétszer jönne létre

## Meglévő erőforrást módosító írási műveletek

Nincs szükség fejlécre. Ahol az ismétlés korábban hibát adott vissza, ott most az aktuális állapotot adja vissza:

| Végpont | Ismételt hívás válasza |
| - | - |
| [Időpont lemondása](https://docs.anivahealth.com/hu/api/appointments/cancel-appointment.md) | `200` a lemondott időponttal |
| [Szállítmány lemondása](https://docs.anivahealth.com/hu/api/shipments/cancel-shipment.md) | `200` a lemondott szállítmánnyal |
| [Otthoni tesztkészlet-rendelés lemondása](https://docs.anivahealth.com/hu/api/home-kit-orders/cancel-home-kit.md) | `200` a lemondott rendeléssel |
| [Otthoni tesztkészlet-rendelés aktiválása](https://docs.anivahealth.com/hu/api/home-kit-orders/activate-home-kit.md) | `200`, ha a mintavétel ideje ugyanaz |
| Panelek vagy biomarkerek eltávolítása | `200`, akár csatolva voltak még, akár nem |

Az ismétlés nem ír semmit, és a válasza tartalmazza az `Idempotent-Replayed: true` fejlécet — ez a fejléc mutatja meg, hogy „én mondtam le” vagy „már le volt mondva”.

Három kivétel esetén ehelyett `409` a válasz:

* **Aktiválás *eltérő* `activated_at` értékkel.** A mintavétel ideje szerepel a laborleleten, ezért egy újrapróbálkozás nem írhatja felül észrevétlenül.
* **Már lemondott időpont lemondása *eltérő* `cancellation_reason` értékkel.** Ugyanebből az okból: a rögzített okot azóta javíthatták, így egy újrapróbálkozás nem írhatja felül. Küldd el újra a rögzített okot, vagy hagyd el.
* **Lemondás a visszafordíthatatlan pont után** — megerősített vérvétel, felvett szállítmány, feladott vagy aktivált tesztkészlet esetén.

Három végpont szándékosan nem ismételhető biztonságosan:

* [Vérvétel megerősítése](https://docs.anivahealth.com/hu/api/appointments/confirm-blood-draw.md) — a második hívás `409` választ ad.
* [Eredmények elküldése e-mailben](https://docs.anivahealth.com/hu/api/appointments/email-results.md) (`POST /v1/appointments/{id}/results/email`) és [Eredmények elküldése e-mailben](https://docs.anivahealth.com/hu/api/home-kit-orders/email-results.md) (`POST /v1/home-kit-orders/{id}/results/email`) — minden hívás küld egy e-mailt. Egy időtúllépés vagy `5xx` utáni újrapróbálkozás duplikált üzenetet küldhet az ügyfélnek.

## Létrehozó írási műveletek

Öt végpont fogad opcionális, legfeljebb 255 karakteres `Idempotency-Key` fejlécet:

* [Profil létrehozása](https://docs.anivahealth.com/hu/api/profiles/create-profile.md)
* [Időpont létrehozása](https://docs.anivahealth.com/hu/api/appointments/create-appointment.md)
* [Otthoni tesztkészlet-rendelés létrehozása](https://docs.anivahealth.com/hu/api/home-kit-orders/create-home-kit.md)
* [Szállítmány létrehozása](https://docs.anivahealth.com/hu/api/shipments/create-shipment.md)
* [Dokumentum feltöltése](https://docs.anivahealth.com/hu/api/documents/upload-document.md)

Egy kulcs, négy próbálkozás, egy rendelés — az, hogy mit kapsz vissza, attól függ, mikor próbálkozol újra, és egyezik-e a kérés törzse:

![Szekvenciadiagram: az első kérés után 350 ms elteltével indított duplikátum 409 választ kap, amíg az első kérés még fut, az első 201 választ ad, egy későbbi újrapróbálkozás ugyanazzal a kulccsal ugyanazt a rendelést adja vissza Idempotent-Replayed jelzéssel, ugyanaz a kulcs módosított törzzsel pedig 409 választ ad.](https://mintcdn.com/anivahealth/8KTut54iIoaIFYY2/images/idempotency-retry.svg?fit=max\&auto=format\&n=8KTut54iIoaIFYY2\&q=85\&s=617f6b19f473ee0fed9243004f932c19)

A kulcsok az API-kulcsodhoz **és** a végponthoz vannak kötve, így sosem ütköznek más partnerek kulcsaival, sem a máshol használt azonos kulccsal.

* **Azonos kulcs, azonos törzs** → 24 órán át az eredeti választ kapod vissza `Idempotent-Replayed: true` jelzéssel. A mezők sorrendje és a whitespace karakterek nem számítanak.
* **Azonos kulcs, eltérő törzs** → `409`.
* **Üres `Idempotency-Key`** → `400`, figyelmen kívül hagyás helyett.

### Mikor szabadul fel a kulcs

A létrehozás **nem atomi** — egy `5xx` válasz nem jelenti azt, hogy nem történt írás.

* **A kérés még azelőtt meghiúsult, hogy bármi létrejött volna** → a kulcs felszabadul, így újra próbálkozhatsz vele.
* **A kérés azután hiúsult meg, hogy már létrejött valami**, vagy **egyáltalán nem érkezett válasz** → a kulcs foglalt marad, és az újrapróbálkozások `409` választ kapnak. Kérd le az erőforrást, hogy ellenőrizd, létezik-e, és ha nem, használj új kulcsot.

> [!NOTE]
>
> Az ismételt válasz az erőforrás létrehozásakor rögzített választörzset adja vissza — pillanatképet,
> nem élő lekérdezést. Ha az erőforrás azóta megváltozott, kérd le közvetlenül.

### Egyes létrehozásoknak természetes kulcsuk is van

Két végpont önmagában, bármilyen fejléctől függetlenül elutasítja a duplikátumokat:

* Az [Időpont létrehozása](https://docs.anivahealth.com/hu/api/appointments/create-appointment.md) profilonként, helyszínenként és időpillanatonként egy időpontot engedélyez. Az ismétlés `409` választ ad a meglévő `appointment_id` azonosítóval.
* A [Profil létrehozása](https://docs.anivahealth.com/hu/api/profiles/create-profile.md) `409` választ ad, ha az `email` címhez már tartozik profil. Ha elhagyod az `email` mezőt, kérésenként egyedi helyőrző generálódik, így az ismétlések *valóban* külön profilokat hoznak létre.

Ha mindkettő fennáll, a természetes kulcs miatti `409` választ kapod, és csak ez tartalmazza a plusz mezőt (`appointment_id`, vagy egy `error_name` megkülönböztető mezőt) — az idempotencia miatti `409` csak az `error` mezőt tartalmazza, ezért olvasd ezeket a mezőket körültekintően.


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