Pāriet uz saturu
ShopentlyLearn

Droša rakstīšana

Apvienojiet idempotences atslēgas un versiju pārbaudes paredzamām izmaiņām.

Sākt darbu

  1. Lasīšana

    Pirms rediģēšanas nolasiet resursu un norādiet expected_version atbilstoši dokumentācijai.

  2. Rakstīšana

    Atbalstītu resursu izveidei izmantojiet POST, daļējai atjaunināšanai PATCH un atbalstītai dzēšanai DELETE.

  3. Atbilde

    Atkārtota veiksmīga darbība atgriež saglabāto rezultātu, nepiemērojot izmaiņu vēlreiz.

Galvenes

Idempotency-Key
Katra resursa rakstīšana prasa Idempotency-Key. Izveidojiet vienu atslēgu katrai loģiskai darbībai; atkārtojot to, saglabājiet to pašu atslēgu, metodi, mērķi un saturu.
expected_version
Cenu izmaiņām var būt vajadzīgas arī produkta, cenas, varianta cenas vai cenrāža versijas. Ja versija mainās, lasiet vēlreiz un saskaņojiet izmaiņu, nevis piespiedu kārtā ievietojiet novecojušus datus.

Atkārtošanas noteikumi

  • Atslēgas izmantošana citam pieprasījumam rada idempotency.key_reused.
  • Visi piemēri ir sintētiski; pirms izpildes aizstājiet identifikatorus ar sava veikala atgrieztajām vērtībām.