Ugrás a fő tartalomhoz

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.
Három végpont szándékosan nem ismételhető biztonságosan:

Létrehozó írási műveletek

Öt végpont fogad opcionális, legfeljebb 255 karakteres Idempotency-Key fejlécet: 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. 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. 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.
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 409 választ ad a meglévő appointment_id azonosítóval.
  • A Profil létrehozása 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.