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.

Back to the chapter