Začínáme
Čtení
Před úpravou zdroj načtěte a podle dokumentace předejte expected_version.
Zápis
POST slouží k vytváření podporovaných zdrojů, PATCH k částečným úpravám a DELETE k podporovanému mazání.
Odpověď
Opakování úspěšné operace vrátí uložený výsledek, aniž by znovu provedlo změnu.
Hlavičky
- Idempotency-Key
- Každý zápis do zdroje vyžaduje Idempotency-Key. Pro jednu logickou operaci vytvořte jeden klíč; při opakování této operace zachovejte stejný klíč, metodu, cíl i obsah požadavku.
- expected_version
- Změny cen mohou vyžadovat také verze produktu, ceny, ceny varianty nebo ceníku. Pokud se verze změní, načtěte data znovu a změnu s nimi slaďte místo vynucování zastaralých údajů.
Pravidla opakování
- Použití stejného klíče pro jiný požadavek vrátí idempotency.key_reused.
- Všechny příklady používají syntetická data; před spuštěním nahraďte identifikátory hodnotami ze svého obchodu.