The DevOpsBeast Blog

Production engineering notes.

Field notes on Kubernetes, GPUs, Linux, and the rest of the production stack, from engineers who run real infrastructure.

API Design··10 min read

A Timeout Tells You Nothing: Designing APIs That Are Safe to Retry

A payment request times out. The client retries. The customer is charged twice, and nothing in your system failed. The problem is that a timeout cannot tell you whether the work happened, and the only two options are losing work or duplicating it. Idempotency is how you pick the second one and make it harmless.

Read post