Rakstīšanas darbības, kas maina esošu resursu
Galvene nav nepieciešama. Tur, kur atkārtots pieprasījums agrāk atgrieza kļūdu, tagad tas atgriež pašreizējo stāvokli:
Atkārtots pieprasījums neko neieraksta, un tā atbildē ir iekļauta galvene
Idempotent-Replayed: true — pēc tās tu vari atšķirt „es to atcēlu” no „tas jau bija atcelts”.
Trīs izņēmumos tā vietā tiek atgriezts 409:
- Aktivizēšana ar citu
activated_at. Parauga paņemšanas laiks tiek iekļauts laboratorijas pārskatā, tāpēc atkārtots mēģinājums to nedrīkst klusām pārrakstīt. - Jau atcelta pieraksta atcelšana ar citu
cancellation_reason. Tas pats pamatojums: ierakstītais iemesls pa šo laiku var būt labots, un atkārtots mēģinājums to nedrīkst pārrakstīt. Nosūti ierakstīto iemeslu vēlreiz vai izlaid to. - Atcelšana pēc neatgriezeniska posma — apstiprinātas asins paņemšanas, savākta sūtījuma, nosūtīta vai aktivizēta komplekta.
- Apstiprināt asins paņemšanu — otrs izsaukums atgriež
409. - Nosūtīt rezultātus e-pastā (
POST /v1/appointments/{id}/results/email) un Nosūtīt rezultātus e-pastā (POST /v1/home-kit-orders/{id}/results/email) — katrs izsaukums nosūta vienu e-pastu. Atkārtots mēģinājums pēc noildzes vai5xxkļūdas var nosūtīt klientam dublikātu.
Rakstīšanas darbības, kas kaut ko izveido
Pieci galapunkti pieņem neobligātu galveniIdempotency-Key, kas ir ne garāka par 255 rakstzīmēm:
- Izveidot profilu
- Izveidot pierakstu
- Izveidot mājas testa komplekta pasūtījumu
- Izveidot sūtījumu
- Augšupielādēt dokumentu
- Tā pati atslēga, tas pats saturs → 24 stundas tu saņem atpakaļ sākotnējo atbildi ar atzīmi
Idempotent-Replayed: true. Lauku secībai un atstarpēm nav nozīmes. - Tā pati atslēga, cits saturs →
409. - Tukša galvene
Idempotency-Key→400, nevis ignorēšana.
Kad atslēga tiek atbrīvota
Izveide nav atomāra —5xx nenozīmē, ka nekas netika ierakstīts.
- Pieprasījums neizdevās, pirms kaut kas tika izveidots → atslēga tiek atbrīvota, tāpēc vari mēģināt vēlreiz ar to pašu atslēgu.
- Pieprasījums neizdevās pēc tam, kad kaut kas jau tika izveidots, vai vispār neatgrieza atbildi → atslēga paliek aizņemta, un atkārtoti mēģinājumi saņem
409. Ielādē resursu, lai pārbaudītu, vai tas eksistē, un, ja tā nav, izmanto jaunu atslēgu.
Atkārtots pieprasījums atgriež atbildes saturu, kas tika saglabāts resursa izveides brīdī —
momentuzņēmumu, nevis aktuālos datus. Ja resurss kopš tā laika ir mainījies, ielādē to tieši.
Dažām izveides darbībām ir arī dabiskā atslēga
Divi galapunkti paši noraida dublikātus neatkarīgi no jebkādas galvenes:- Izveidot pierakstu pieļauj vienu pierakstu vienam profilam, vienā atrašanās vietā un vienā laikā. Atkārtots pieprasījums atgriež
409ar esošoappointment_id. - Izveidot profilu atgriež
409, jaemailjau ir piesaistīts profils. Izlaidemail, un katram pieprasījumam tiek ģenerēts unikāls vietturis, tāpēc atkārtoti pieprasījumi tiešām izveido atsevišķus profilus.
409, un tikai tas satur papildu lauku (appointment_id vai error_name diskriminatoru) — idempotences 409 satur tikai error, tāpēc nolasi šos laukus piesardzīgi.