Skriveoperasjoner som endrer en eksisterende ressurs
Ingen header er involvert. Der en gjentakelse tidligere returnerte en feil, returnerer den nå gjeldende tilstand:
En gjentakelse skriver ingenting, og svaret inneholder
Idempotent-Replayed: true — denne headeren lar deg skille mellom «jeg kansellerte den» og «den var allerede kansellert».
Tre unntak returnerer 409 i stedet:
- Aktivering med et annet
activated_at. Prøvetakingstidspunktet står i laboratorierapporten, så et nytt forsøk må ikke overskrive det i stillhet. - Kansellering av en allerede kansellert time med en annen
cancellation_reason. Samme logikk: den registrerte årsaken kan ha blitt rettet i ettertid, og et nytt forsøk må ikke overskrive den. Send den registrerte årsaken på nytt, eller utelat den. - Kansellering når det ikke lenger kan gjøres om — en bekreftet blodprøvetaking, en hentet forsendelse, et sendt eller aktivert sett.
- Bekreft blodprøvetaking — kall nummer to returnerer
409. - Send resultater på e-post (
POST /v1/appointments/{id}/results/email) og Send resultater på e-post (POST /v1/home-kit-orders/{id}/results/email) — hvert kall sender én e-post. Et nytt forsøk etter et tidsavbrudd eller en5xxkan sende kunden et duplikat.
Skriveoperasjoner som oppretter noe
Fem endepunkter godtar en valgfriIdempotency-Key-header på maksimalt 255 tegn:
- Opprett profil
- Opprett time
- Opprett bestilling av hjemmetestsett
- Opprett forsendelse
- Last opp dokument
- Samme nøkkel, samme innhold → i 24 timer får du det opprinnelige svaret tilbake, merket
Idempotent-Replayed: true. Rekkefølgen på feltene og blanktegn har ingen betydning. - Samme nøkkel, annet innhold →
409. - En tom
Idempotency-Key→400, i stedet for å bli ignorert.
Når nøkkelen frigis
Opprettelse er ikke atomær — en5xx betyr ikke at ingenting ble skrevet.
- Forespørselen feilet før noe ble opprettet → nøkkelen frigis, så du kan prøve på nytt med den.
- Forespørselen feilet etter at noe ble opprettet, eller returnerte aldri → nøkkelen forblir opptatt, og nye forsøk får
409. Hent ressursen for å sjekke om den finnes, og bruk deretter en ny nøkkel hvis den ikke gjør det.
En gjentakelse returnerer svarinnholdet som ble registrert da ressursen ble opprettet — et øyeblikksbilde, ikke en
sanntidslesing. Hvis ressursen har endret seg siden da, henter du den direkte.
Noen opprettelser har også en naturlig nøkkel
To endepunkter avviser duplikater på egen hånd, uavhengig av eventuell header:- Opprett time tillater én time per profil, lokasjon og tidspunkt. En gjentakelse returnerer
409med eksisterendeappointment_id. - Opprett profil returnerer
409nåremailallerede har en profil. Utelater duemail, genereres en unik plassholder per forespørsel, så gjentakelser oppretter faktisk separate profiler.
409 fra den naturlige nøkkelen du får, og bare den inneholder ekstrafeltet (appointment_id, eller en error_name-diskriminator) — en 409 fra idempotens inneholder bare error, så les disse feltene defensivt.