Ibda
Qari
Aqra r-riżorsa qabel teditjaha u agħti expected_version kif dokumentat.
Kitba
Uża POST biex toħloq riżorsi appoġġati, PATCH għal aġġornamenti parzjali u DELETE għal tħassir appoġġat.
Risposta
Operazzjoni li rnexxiet u tiġi ripetuta tirritorna r-riżultat maħżun mingħajr ma tapplika l-bidla mill-ġdid.
Headers
- Idempotency-Key
- Kull kitba ta’ riżorsa teħtieġ Idempotency-Key. Oħloq ċavetta waħda għal kull operazzjoni loġika; f’tentattiv ieħor żomm l-istess ċavetta, metodu, mira u kontenut.
- expected_version
- Tibdil fil-prezz jista’ jeħtieġ ukoll verżjonijiet tal-prodott, tal-prezz, tal-prezz tal-varjant jew tal-lista tal-prezzijiet. Jekk verżjoni tinbidel, aqra mill-ġdid u rrikonċilja l-bidla minflok tisforza data skaduta.
Politika ta’ tentattivi mill-ġdid
- L-użu tal-istess ċavetta għal talba differenti jagħti idempotency.key_reused.
- Kull eżempju huwa sintetiku; qabel tesegwih ibdel l-identifikaturi b’valuri miksuba mill-ħanut tiegħek.