Přejít na hlavní obsah

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: 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í:

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ů: 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. 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. 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íč.
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 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 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ě.