Preskoči na vsebino
ShopentlyLearn

Varni zapisi

Za predvidljive posodobitve združite ključe idempotentnosti s preverjanjem različic.

Začetek

  1. Branje

    Pred urejanjem preberite vir in posredujte expected_version skladno z dokumentacijo.

  2. Pisanje

    Za ustvarjanje podprtih virov uporabite POST, za delne posodobitve PATCH in za podprto brisanje DELETE.

  3. Odgovor

    Ponovljena uspešna operacija vrne shranjeni rezultat brez ponovne uporabe spremembe.

Glave

Idempotency-Key
Vsak zapis vira zahteva Idempotency-Key. Ustvarite en ključ na logično operacijo; pri ponovitvi te operacije ohranite isti ključ, metodo, cilj in podatke.
expected_version
Spremembe cen lahko zahtevajo tudi različice izdelka, cene, cene različice izdelka ali cenika. Če se različica spremeni, znova preberite podatke in uskladite posodobitev, namesto da vsilite zastarele podatke.

Pravila ponavljanja

  • Ponovna uporaba ključa za drugo zahtevo vrne idempotency.key_reused.
  • Vsi primeri so sintetični; pred izvedbo zamenjajte identifikatorje z vrednostmi iz svoje trgovine.