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

> Bezpečně zopakuj jakýkoli zápis, aniž by se něco vytvořilo dvakrát

## Zápisy, které mění existující zdroj

Žádná hlavička se nepoužívá. Tam, kde opakované volání dříve vracelo chybu, teď vrací aktuální stav:

| Endpoint | Opakované volání vrátí |
| - | - |
| [Zrušit termín](https://docs.anivahealth.com/cs/api/appointments/cancel-appointment.md) | `200` se zrušeným termínem |
| [Zrušit zásilku](https://docs.anivahealth.com/cs/api/shipments/cancel-shipment.md) | `200` se zrušenou zásilkou |
| [Zrušit objednávku domácí testovací sady](https://docs.anivahealth.com/cs/api/home-kit-orders/cancel-home-kit.md) | `200` se zrušenou objednávkou |
| [Aktivovat objednávku domácí testovací sady](https://docs.anivahealth.com/cs/api/home-kit-orders/activate-home-kit.md) | `200`, pokud je čas odběru stejný |
| Odebrání panelů nebo biomarkerů | `200`, ať už byly ještě přiřazené, nebo ne |

Opakované volání nic nezapíše a v odpovědi je hlavička `Idempotent-Replayed: true` — podle ní odlišíš „zrušil jsem to“ od „už to bylo zrušené“.

Tři výjimky místo toho vrací `409`:

* **Aktivace s *jiným* `activated_at`.** Čas odběru se propisuje do laboratorní zprávy, takže ho opakovaný pokus nesmí tiše přepsat.
* **Zrušení už zrušeného termínu s *jiným* `cancellation_reason`.** Stejná logika: zaznamenaný důvod mohl být mezitím opravený a opakovaný pokus ho nesmí přepsat. Pošli znovu zaznamenaný důvod, nebo ho vynech.
* **Zrušení, když už není cesty zpět** — potvrzený odběr krve, vyzvednutá zásilka, odeslaná nebo aktivovaná sada.

Tři endpointy záměrně nejsou bezpečné pro opakování:

* [Potvrdit odběr krve](https://docs.anivahealth.com/cs/api/appointments/confirm-blood-draw.md) — druhé volání vrátí `409`.
* [Poslat výsledky e-mailem](https://docs.anivahealth.com/cs/api/appointments/email-results.md) (`POST /v1/appointments/{id}/results/email`) a [Poslat výsledky e-mailem](https://docs.anivahealth.com/cs/api/home-kit-orders/email-results.md) (`POST /v1/home-kit-orders/{id}/results/email`) — každé volání odešle jeden e-mail. Opakování po timeoutu nebo chybě `5xx` může zákazníkovi poslat duplikát.

## Zápisy, které něco vytvářejí

Pět endpointů přijímá volitelnou hlavičku `Idempotency-Key` o délce nejvýše 255 znaků:

* [Vytvořit profil](https://docs.anivahealth.com/cs/api/profiles/create-profile.md)
* [Vytvořit termín](https://docs.anivahealth.com/cs/api/appointments/create-appointment.md)
* [Vytvořit objednávku domácí testovací sady](https://docs.anivahealth.com/cs/api/home-kit-orders/create-home-kit.md)
* [Vytvořit zásilku](https://docs.anivahealth.com/cs/api/shipments/create-shipment.md)
* [Nahrát dokument](https://docs.anivahealth.com/cs/api/documents/upload-document.md)

Jeden klíč, čtyři pokusy, jedna objednávka — co dostaneš zpět, záleží na tom, kdy pokus opakuješ a jestli se tělo požadavku shoduje:

![Sekvenční diagram: duplicitní požadavek odeslaný 350 ms po prvním dostane odpověď 409, protože první ještě běží, první vrátí 201, pozdější opakování se stejným klíčem vrátí tutéž objednávku označenou Idempotent-Replayed a stejný klíč se změněným tělem vrátí 409.](https://mintcdn.com/anivahealth/8KTut54iIoaIFYY2/images/idempotency-retry.svg?fit=max\&auto=format\&n=8KTut54iIoaIFYY2\&q=85\&s=617f6b19f473ee0fed9243004f932c19)

Klíče jsou vymezené pro tvůj API klíč **a** pro daný endpoint, takže nikdy nekolidují s klíči jiného partnera ani se stejným klíčem použitým jinde.

* **Stejný klíč, stejné tělo** → po dobu 24 hodin dostaneš zpět původní odpověď označenou `Idempotent-Replayed: true`. Na pořadí polí a bílých znacích nezáleží.
* **Stejný klíč, jiné tělo** → `409`.
* **Prázdný `Idempotency-Key`** → `400`, místo aby se ignoroval.

### Kdy se klíč uvolní

Vytváření **není atomické** — chyba `5xx` neznamená, že se nic nezapsalo.

* **Požadavek selhal dřív, než se něco vytvořilo** → klíč se uvolní, takže pod ním můžeš pokus zopakovat.
* **Požadavek selhal až poté, co se něco vytvořilo**, nebo **se vůbec nevrátil** → klíč zůstane obsazený a opakované pokusy dostanou `409`. Načti zdroj a ověř, jestli existuje; pokud ne, použij nový klíč.

> [!NOTE]
>
> Opakování vrátí tělo odpovědi zaznamenané při vytvoření zdroje — jde o snímek z té doby, ne o
> aktuální stav. Pokud se zdroj mezitím změnil, načti ho přímo.

### Některé vytvářecí operace mají i přirozený klíč

Dva endpointy odmítají duplikáty samy o sobě, nezávisle na jakékoli hlavičce:

* [Vytvořit termín](https://docs.anivahealth.com/cs/api/appointments/create-appointment.md) povoluje jeden termín na profil, odběrové místo a čas. Opakování vrátí `409` s existujícím `appointment_id`.
* [Vytvořit profil](https://docs.anivahealth.com/cs/api/profiles/create-profile.md) vrátí `409`, když pro daný `email` už profil existuje. Pokud `email` vynecháš, vygeneruje se pro každý požadavek unikátní zástupná hodnota, takže opakování samostatné profily *vytvoří*.

Když platí obojí, uvidíš `409` z přirozeného klíče a jen to obsahuje pole navíc (`appointment_id` nebo rozlišovač `error_name`) — `409` z idempotence obsahuje jen `error`, takže tato pole čti defenzivně.


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