Api Error Design
samber/developer-platform-skills/skills/api-error-design作者 samber594cf70d343eMIT3 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫10 天前更新
Design the error surface of a public API so integrators self-serve fixes - a machine-readable error-code taxonomy (flat catalog, code/subcode, Google-style domain/reason), the RFC 9457 problem-details envelope with extension members, actionable error messages, retryability signaling (retryable flag, Retry-After), and per-endpoint error documentation with request-ID tracking. Use whenever the user mentions API error codes, an error taxonomy, RFC 9457, application/problem+json, 4xx/5xx response bodies, or confusing API error messages - even if they never say "error design". Do NOT use for client-side retry mechanics - use samber/developer-platform-skills@api-idempotency-retry - nor for incident and status-page communication - use samber/developer-platform-skills@api-status-communication instead.
僅公開檔案列表。將技能安裝到工作區後即可檢視檔案內容。
| 路徑 | 大小 | 類型 |
|---|---|---|
| evals/evals.json | 26.4 KB | application/json |
| references/error-documentation-examples.md | 3.8 KB | text/markdown |
| references/message-rewrite-examples.md | 3.5 KB | text/markdown |
| references/rfc9457-payload-examples.md | 4.7 KB | text/markdown |
| references/taxonomy-catalog-examples.md | 5.4 KB | text/markdown |
| SKILL.md | 18 KB | text/markdown |
來源與署名
來源：samber/developer-platform-skills位於skills/api-error-design提交594cf70
授權條款： MIT
內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。
更多來自 samber/developer-platform-skills 的技能
Webhook Platform Design
samber
設計供應方出站 Webhook 平台：事件目錄、酬載封裝、簽章、重試、訂閱與除錯介面。
Sql Jdbc Access Design
samber
設計面向客戶的 SQL 資料存取方案，涵蓋架構、隔離、結構描述契約、治理與定價。
Sdk Portfolio Strategy
samber
指導平台團隊撰寫公開 API 的 SDK 組合策略：語言順序、建置模式、支援層級、版本管理與退役。
Public Graphql Api Design
samber
設計供第三方使用的公開 GraphQL API：結構定義慣例、Relay 分頁、具型別錯誤、防護上限與聯邦邊界。
Public Api Design Review
samber
以檢核清單驅動的公開 REST API 設計審查，將發現項目依引用規則歸為必須修改或改進。
Partner App Onboarding
samber
為 B2B SaaS 平台設計合作夥伴開發者入駐歷程，從註冊到首次提交應用程式，涵蓋准入、環境開通、教育、支援與漏斗指標。
更多Software Development技能
Playground
anthropics
建立自成一體的互動式 HTML 遊樂場，包含控制項、即時預覽與可複製的提示詞輸出。
M5 Onboard
anthropics
透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。
Cardputer Buddy
anthropics
指導迭代 Cardputer-Adv 的 MicroPython 應用程式套件：新增應用程式、透過 USB 序列埠推送檔案、查看日誌並執行 REPL 指令。
Web Design Guidelines
vercel-labs
依據從遠端來源取得的 Web Interface Guidelines 審查 UI 程式碼，並以 file:line 形式回報問題。
Vercel React Native Skills
vercel-labs
React Native 與 Expo 最佳實務規則，涵蓋清單效能、動畫、導覽、UI 模式、狀態與 monorepo 設定。
Vercel React Best Practices
vercel-labs
Vercel 的 React 與 Next.js 效能指南，以 70 條規則的形式用於撰寫、審查與重構程式碼。