API Design

Designing Idempotent APIs: Because "Just Retry It" Can Cost You Money

Every network call has three outcomes, not two: success, failure, and the one nobody designs for — you have no idea whether it happened. Idempotency is how you make that third case safe, and getting it wrong charges the card twice.