Try It: Retry Contract Card
Try It: Retry Contract Card
animation
soa
api
design-patterns
TipTry It: Retry Contract Card
Choose one command endpoint and write the retry contract before implementation:
- Logical action: the exact command that one idempotency key represents.
- First request result: status code, command identifier, and response body returned when the command is accepted.
- Duplicate retry result: response returned when the same key arrives again after a timeout.
- Retry boundary: how long the key is retained and when a client must create a new key.
- Overload behavior: the
429,Retry-After, and problem-detail fields clients should obey. - Suppression signal: the metric or log entry that proves duplicate dispatch was suppressed.