Pradžia
Skaitymas
Prieš redaguodami perskaitykite išteklių ir pagal dokumentaciją pateikite expected_version.
Rašymas
Palaikomus išteklius kurkite su POST, iš dalies atnaujinkite su PATCH ir šalinkite su DELETE.
Atsakymas
Pakartota sėkminga operacija grąžina išsaugotą rezultatą, dar kartą neatlikdama pakeitimo.
Antraštės
- Idempotency-Key
- Kiekvienam ištekliaus įrašymui reikia Idempotency-Key. Vienai loginei operacijai sukurkite vieną raktą; ją kartodami naudokite tą patį raktą, metodą, tikslą ir duomenis.
- expected_version
- Kainų pakeitimams gali reikėti ir produkto, kainos, produkto varianto kainos ar kainoraščio versijų. Versijai pasikeitus, skaitykite iš naujo ir suderinkite pakeitimą, užuot priverstinai įrašę pasenusius duomenis.
Kartojimo taisyklės
- Tas pats raktas kitai užklausai sukelia idempotency.key_reused.
- Visi pavyzdžiai yra sintetiniai; prieš vykdydami pakeiskite identifikatorius reikšmėmis iš savo parduotuvės.