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 条规则的形式用于编写、审查和重构代码。