Api Idempotency Retry

samber/developer-platform-skills/skills/api-idempotency-retry

by samber594cf70d343eMIT3 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 10 days ago

Design idempotency-key support and client retry guidance for a public API so integrators retry safely - key derivation and per-caller scoping, storage TTL and replay windows, atomic claim mechanisms (DB unique constraint, SERIALIZABLE row lock, conditional writes), payload-mismatch rejection, in-flight duplicate handling, exponential backoff with jitter, retry budgets, timeout propagation, and SDK retry defaults. Use whenever the user mentions an Idempotency-Key header, duplicate or double-submitted requests, safe POST retries, backoff, or jitter - even if they never say "idempotency". Do NOT use for what the error response signals (samber/developer-platform-skills@api-error-design) or webhook delivery retries (samber/developer-platform-skills@webhook-platform-design).

Only the file list is public. File contents are available once the skill is installed in a workspace.

PathSizeType
evals/evals.json28.3 KBapplication/json
references/backoff-jitter-formulas.md5.4 KBtext/markdown
references/key-lifecycle-walkthrough.md6.5 KBtext/markdown
references/vendor-sdk-retry-defaults.md4.7 KBtext/markdown
SKILL.md22.6 KBtext/markdown

Source and attribution

Source:samber/developer-platform-skillsinskills/api-idempotency-retryat commit594cf70

License: MIT

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal