Pāriet uz galveno saturu

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.
Trīs galapunkti apzināti nav droši atkārtotiem mēģinājumiem:

Rakstīšanas darbības, kas kaut ko izveido

Pieci galapunkti pieņem neobligātu galveni Idempotency-Key, kas ir ne garāka par 255 rakstzīmēm: Viena atslēga, četri mēģinājumi, viens pasūtījums — tas, ko saņem atpakaļ, ir atkarīgs no atkārtošanas brīža un no tā, vai pieprasījuma saturs sakrīt: Secības diagramma: dublikāts, kas nosūtīts 350 ms pēc pirmā pieprasījuma, saņem 409, kamēr pirmais pieprasījums vēl darbojas; pirmais atgriež 201, vēlāks atkārtots mēģinājums ar to pašu atslēgu atgriež to pašu pasūtījumu ar atzīmi Idempotent-Replayed, bet tā pati atslēga ar mainītu saturu atgriež 409. Secības diagramma: dublikāts, kas nosūtīts 350 ms pēc pirmā pieprasījuma, saņem 409, kamēr pirmais pieprasījums vēl darbojas; pirmais atgriež 201, vēlāks atkārtots mēģinājums ar to pašu atslēgu atgriež to pašu pasūtījumu ar atzīmi Idempotent-Replayed, bet tā pati atslēga ar mainītu saturu atgriež 409. Atslēgas ir piesaistītas tavai API atslēgai un galapunktam, tāpēc tās nekad nesaduras ar citu partneru atslēgām vai to pašu atslēgu, kas izmantota citur.
  • 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ž 409 ar esošo appointment_id.
  • Izveidot profilu atgriež 409, ja email jau ir piesaistīts profils. Izlaid email, un katram pieprasījumam tiek ģenerēts unikāls vietturis, tāpēc atkārtoti pieprasījumi tiešām izveido atsevišķus profilus.
Ja attiecas abi, tu redzi dabiskās atslēgas 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.