retry contract
Idempotency
Idempotency
Also known as · idempotent · duplicate request safety · retry safety
Definition
The property that repeated processing of the same intent converges on the same observable business state as one processing. It limits duplicate effects instead of pretending retries do not happen.
Searchable examples
- Idempotency-Key: order-123
- ON CONFLICT DO NOTHING
Short example
INSERT INTO jobs (request_key, state)
VALUES ($1, 'accepted')
ON CONFLICT (request_key) DO NOTHING;
Define the key scope, retention window, and conflict response too.