Začíname
Čítanie
Pred úpravou zdroj načítajte a podľa dokumentácie odovzdajte expected_version.
Zápis
POST slúži na vytváranie podporovaných zdrojov, PATCH na čiastočné úpravy a DELETE na podporované mazanie.
Odpoveď
Opakovanie úspešnej operácie vráti uložený výsledok bez opätovného vykonania zmeny.
Hlavičky
- Idempotency-Key
- Každý zápis do zdroja vyžaduje Idempotency-Key. Pre jednu logickú operáciu vytvorte jeden kľúč; pri opakovaní tejto operácie zachovajte rovnaký kľúč, metódu, cieľ aj obsah požiadavky.
- expected_version
- Zmeny cien môžu vyžadovať aj verzie produktu, ceny, ceny variantu alebo cenníka. Ak sa verzia zmení, načítajte údaje znova a zmenu s nimi zosúlaďte namiesto vynucovania zastaraných údajov.
Pravidlá opakovania
- Použitie rovnakého kľúča pre inú požiadavku vráti idempotency.key_reused.
- Všetky príklady používajú syntetické údaje; pred spustením nahraďte identifikátory hodnotami zo svojho obchodu.