Api Idempotency Retry

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

作者 samber594cf70d343eMIT3 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫10 天前更新

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).

新增到 SourceWeft 工作區

  1. 在儀表板中開啟該技能,並將它新增到工作區。
  2. 為需要使用它的對話啟用該技能。

該技能僅含說明:不附帶任何可執行的腳本。

新增到 SourceWeft

系統會先要求你登入,然後直接帶你回到這個技能。

讓你的代理程式來安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 或其他能執行命令的代理程式中,也可以貼上到 SourceWeft 對話裡。代理程式會閱讀這個技能的安裝說明,向你展示它的來源、授權條款和腳本情況,在你同意後用 SourceWeft CLI 安裝。

閱讀 https://sourceweft.com/skills/gh-samber-developer-platform-skills-api-idempotency-retry/install.md 中的說明,按說明安裝這個技能。安裝前先告訴我它的來源、授權條款以及是否附帶腳本,等我確認。修改我電腦上的其他任何內容之前也要先問我。

檢視代理程式所遵循的安裝說明

用命令列自行安裝

適用於 Claude Code、Codex、Cursor 及其他本機代理程式。SourceWeft CLI 會從原始碼儲存庫中取得此處掃描過的那次提交,並根據掃描時記錄的雜湊值逐一驗證每個檔案。只要有任何不一致,就不會寫入任何內容。

npx @sourceweft/cli skills install @samber/api-idempotency-retry

新增 --agent claude-code、codex、cursor 或 universal 來選擇安裝給哪個代理程式(預設為 Claude Code)。

上游安裝器——未經 SourceWeft 驗證

開源的 skills 安裝器會取得同一個固定的提交,但不會根據 SourceWeft 記錄的雜湊值驗證檔案。

npx skills add https://github.com/samber/developer-platform-skills/tree/594cf70d343e34339e8f83610e33b0b2c3945fd4/skills/api-idempotency-retry

來源與署名

來源:samber/developer-platform-skills位於skills/api-idempotency-retry提交594cf70

授權條款: MIT

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架