Aloita
Luku
Lue resurssi ennen muokkausta ja anna expected_version dokumentoidulla tavalla.
Kirjoitus
Käytä POST-metodia tuettujen resurssien luontiin, PATCH-metodia osittaisiin päivityksiin ja DELETE-metodia tuettuihin poistoihin.
Vastaus
Onnistuneen toiminnon toistaminen palauttaa tallennetun tuloksen tekemättä muutosta uudelleen.
Otsakkeet
- Idempotency-Key
- Jokainen resurssin kirjoitus edellyttää Idempotency-Key-otsaketta. Luo yksi avain kutakin loogista toimintoa kohti. Käytä samaa avainta, metodia, kohdetta ja sisältöä, kun yrität toimintoa uudelleen.
- expected_version
- Hintamuutokset voivat edellyttää myös tuotteen, hinnan, varianttihinnan tai hinnaston versioita. Jos versio muuttuu, lue tiedot uudelleen ja sovita päivitys niihin sen sijaan, että pakottaisit vanhentuneet tiedot voimaan.
Uudelleenyrityskäytäntö
- Avaimen käyttö eri pyyntöön tuottaa idempotency.key_reused-virheen.
- Jokainen esimerkki on synteettinen.
- Korvaa tunnisteet omasta kaupastasi saaduilla arvoilla ennen esimerkin suorittamista.