Siirry pääsisältöön

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.
Kolme päätepistettä ei tarkoituksella ole turvallisia toistaa:

Uutta luovat kirjoitukset

Viisi päätepistettä hyväksyy valinnaisen Idempotency-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: Sekvenssikaavio: 350 ms ensimmäisen pyynnön jälkeen lähetetty toistettu pyyntö saa vastauksen 409 ensimmäisen pyynnön ollessa yhä käynnissä, ensimmäinen palauttaa koodin 201, myöhempi uusintayritys samalla avaimella palauttaa saman tilauksen merkinnällä Idempotent-Replayed ja sama avain muutetulla rungolla palauttaa koodin 409. Sekvenssikaavio: 350 ms ensimmäisen pyynnön jälkeen lähetetty toistettu pyyntö saa vastauksen 409 ensimmäisen pyynnön ollessa yhä käynnissä, ensimmäinen palauttaa koodin 201, myöhempi uusintayritys samalla avaimella palauttaa saman tilauksen merkinnällä Idempotent-Replayed ja sama avain muutetulla rungolla palauttaa koodin 409. Avaimet rajataan API-avaimeesi ja päätepisteeseen, joten ne eivät koskaan törmää toisen kumppanin avaimiin tai samaan avaimeen muualla.
  • 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 409 ja olemassa olevan appointment_id-tunnuksen.
  • Luo profiili palauttaa koodin 409, kun email-osoitteella on jo profiili. Jos jätät email-kentän pois, jokaiselle pyynnölle luodaan yksilöllinen paikkamerkki, joten toistot luovat erilliset profiilit.
Kun molemmat pätevät, saat luonnollisen avaimen 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.