Skip to content

Idempotency

An idempotent operation has the same intended effect on system state when repeated identically as when performed once.

APIs and data contracts

Idempotency means that repeating an identical operation has the same intended effect on system state as performing it once. Responses or logs do not have to be identical each time.

A fictional ERP call creates order W-240 with stable key shop-1:W-240:create. If the destination reliably recognises that key, retrying must not create a second order. Key scope, payload and retention must match the API's actual supported rules.

Sending a key provides no protection if the receiver ignores it. The HTTP method name alone also does not establish a business-correct integration. Idempotency describes repetition's effect; a retry strategy determines when another attempt occurs.

Sources