api-design - 设计一致的 REST API
提供 REST 资源设计、HTTP 语义、响应格式、分页、过滤、身份验证、速率限制和版本控制的规范。
标签
更新于: 2026-09-28能力
典型输入
典型输出
该技能可以做什么
- 设计资源 URL
- 选择 HTTP 方法
- 定义状态码
- 设计响应信封
- 选择分页策略
- 指定过滤和排序
- 规划身份验证和授权
- 建议速率限制
- 规划 API 版本控制
输入
- API 需求
- 现有 API 契约
- 分页需求
- 过滤需求
- 版本控制需求
- 身份验证需求
输出
- API 设计建议
- 端点规范
- 响应格式规范
- 分页规范
- 错误响应规范
- 版本控制建议