IDEMPOTENCY IS EASY UNTIL THE SECOND REQUEST IS DIFFERENT

Summary from the TLDR Dev newsletter

True idempotency goes beyond replaying responses and must address complex issues like concurrent requests, partial failures, and state mismatches. To maintain consistency and prevent duplicate actions, the server must use atomic operations, hash the validated command, and differentiate between genuine retries and conflicting commands using the same key.