Olemassa olevaa resurssia muuttavat kirjoitukset
Otsikkokenttää ei tarvita. Siinä missä toisto aiemmin palautti virheen, se palauttaa nyt nykyisen tilan:
Toisto ei kirjoita mitään, ja sen vastauksessa on
Idempotent-Replayed: true — tämän otsikkokentän avulla erotat, peruitko sen itse vai oliko se jo peruttu.
Kolme poikkeusta palauttaa sen sijaan koodin 409:
- Aktivointi eri
activated_at-arvolla. Näytteenottoaika merkitään laboratorioraporttiin, joten uusintayritys ei saa korvata sitä huomaamatta. - Jo perutun ajanvarauksen peruminen eri
cancellation_reason-arvolla. Sama perustelu: kirjattua syytä on voitu korjata sen jälkeen, eikä uusintayritys saa korvata sitä. Lähetä kirjattu syy uudelleen tai jätä se pois. - Peruminen peruuttamattoman vaiheen jälkeen — vahvistettu verinäytteenotto, noudettu lähetys, lähetetty tai aktivoitu pakkaus.
- Vahvista verinäytteenotto — toinen kutsu palauttaa koodin
409. - Lähetä tulokset sähköpostilla (
POST /v1/appointments/{id}/results/email) ja Lähetä tulokset sähköpostilla (POST /v1/home-kit-orders/{id}/results/email) — jokainen kutsu lähettää yhden sähköpostin. Uusintayritys aikakatkaisun tai5xx-virheen jälkeen voi lähettää asiakkaalle kaksoiskappaleen.
Uutta luovat kirjoitukset
Viisi päätepistettä hyväksyy valinnaisenIdempotency-Key-otsikkokentän, jonka enimmäispituus on 255 merkkiä:
Yksi avain, neljä yritystä, yksi tilaus — palautettava vastaus riippuu siitä, milloin yrität uudelleen ja täsmääkö pyynnön runko:
- Sama avain, sama runko → saat 24 tunnin ajan takaisin alkuperäisen vastauksen merkinnällä
Idempotent-Replayed: true. Kenttien järjestyksellä ja tyhjämerkeillä ei ole merkitystä. - Sama avain, eri runko →
409. - Tyhjä
Idempotency-Key→400, eikä sitä ohiteta.
Milloin avain vapautetaan
Luonti ei ole atominen —5xx-virhe ei tarkoita, ettei mitään olisi kirjoitettu.
- Pyyntö epäonnistui ennen kuin mitään luotiin → avain vapautetaan, joten voit yrittää uudelleen samalla avaimella.
- Pyyntö epäonnistui sen jälkeen, kun jotain luotiin, tai ei palannut lainkaan → avain pysyy varattuna ja uusintayritykset saavat koodin
409. Hae resurssi tarkistaaksesi, onko se olemassa, ja käytä uutta avainta, jos ei ole.
Toisto palauttaa resurssin luontihetkellä tallennetun vastauksen rungon — tilannekuvan, ei
reaaliaikaista lukua. Jos resurssi on muuttunut sen jälkeen, hae se suoraan.
Joillakin luontikutsuilla on myös luonnollinen avain
Kaksi päätepistettä hylkää kaksoiskappaleet itse, otsikkokentistä riippumatta:- Luo ajanvaraus sallii yhden ajanvarauksen profiilia, toimipistettä ja ajankohtaa kohden. Toisto palauttaa koodin
409ja olemassa olevanappointment_id-tunnuksen. - Luo profiili palauttaa koodin
409, kunemail-osoitteella on jo profiili. Jos jätätemail-kentän pois, jokaiselle pyynnölle luodaan yksilöllinen paikkamerkki, joten toistot luovat erilliset profiilit.
409-vastauksen, ja vain se sisältää lisäkentän (appointment_id tai error_name-erottimen) — idempotenssin 409-vastaus sisältää pelkän error-kentän, joten tarkista näiden kenttien olemassaolo ennen lukemista.