SELF-GUIDED BA PRACTICE Packages available · Access after confirmed paymentSee packages ↗

Business analysis glossary

Idempotency Key

What it is

An idempotency key is a unique value a client sends with a request, usually in a header, so the server can recognise repeats of the same request. If the same key arrives again with the same content, the server returns the original result instead of acting twice; the same key with different content is rejected.

Why it matters

It is the practical tool that makes retries safe for payments, orders and other create operations. Analysts should require keys for any operation where a duplicate would cause harm, define how long keys are remembered and specify the response when a key is reused with a different request.

Example

The analyst's requirement for the transfer API says every request must carry an idempotency key, keys are kept for twenty four hours, a repeat with the same key and body returns the first result with a replayed flag and a repeat with a different body returns 422. Testers check all three cases.

CHECK BEFORE CONTINUING

Keep your work safe