Mine sisu juurde
ShopentlyLearn

Turvalised muudatused

Ühenda idempotentsusvõtmed versioonikontrolliga, et muudatused oleksid ennustatavad.

Alustamine

  1. Lugemine

    Loe ressurss enne muutmist ja lisa expected_version dokumentatsiooni järgi.

  2. Kirjutamine

    Kasuta toetatud ressursside loomiseks POST, osaliseks muutmiseks PATCH ja toetatud kustutamiseks DELETE.

  3. Vastus

    Korduv edukas toiming tagastab salvestatud tulemuse muudatust uuesti rakendamata.

Päised

Idempotency-Key
Iga ressursimuudatus nõuab Idempotency-Key päist. Loo üks võti loogilise toimingu kohta; kordamisel kasuta sama võtit, meetodit, sihti ja sisu.
expected_version
Hinnamuudatused võivad nõuda ka toote, hinna, variandihinna või hinnakirja versioone. Versiooni muutumisel loe andmed uuesti ja kooskõlasta muudatus, mitte ära sunni peale vananenud andmeid.

Korduskatsete reeglid

  • Sama võtme kasutamine erineva päringu jaoks annab idempotency.key_reused.
  • Kõik näited kasutavad sünteetilisi andmeid; enne käivitamist asenda identifikaatorid oma poe andmetest saadud väärtustega.