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:
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.
- Vérvétel megerősítése — a második hívás
409választ ad. - Eredmények elküldése e-mailben (
POST /v1/appointments/{id}/results/email) és Eredmények elküldése e-mailben (POST /v1/home-kit-orders/{id}/results/email) — minden hívás küld egy e-mailt. Egy időtúllépés vagy5xxutá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 karakteresIdempotency-Key fejlécet:
- Profil létrehozása
- Időpont létrehozása
- Otthoni tesztkészlet-rendelés létrehozása
- Szállítmány létrehozása
- Dokumentum feltöltése
- Azonos kulcs, azonos törzs → 24 órán át az eredeti választ kapod vissza
Idempotent-Replayed: truejelzé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 — egy5xx 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
409választ kapnak. Kérd le az erőforrást, hogy ellenőrizd, létezik-e, és ha nem, használj új kulcsot.
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 profilonként, helyszínenként és időpillanatonként egy időpontot engedélyez. Az ismétlés
409választ ad a meglévőappointment_idazonosítóval. - A Profil létrehozása
409választ ad, ha azemailcímhez már tartozik profil. Ha elhagyod azemailmező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.
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.