Idempotency Keys, Properly: Why "Just Make It Idempotent" Is Harder Than It Sounds
Every retry-safe design depends on idempotency, and most candidates cannot say how it actually works. Here is the full mechanism: who generates the key, what its scope is, where the record lives, how to make the check atomic, what to return on a replay, and how long to keep it.