api-design - REST API 设计模式与最佳实践
应用 REST API 设计模式，包括资源命名、状态码、分页、过滤和错误响应。
标签
更新于: 2026-03-26能力
典型输入
典型输出
该技能可以做什么
- 设计 API 端点
- 审核 API 契约
- 定义 HTTP 方法
- 分配状态码
- 实现分页
- 添加过滤
- 添加排序
- 构建错误响应
- 配置速率限制
- 规划 API 版本控制
输入
- API 需求
- 资源数据模型
- 业务逻辑
- 用例规范
- 认证配置
输出
- API 端点定义
- HTTP 方法规范
- 状态码映射
- 请求/响应架构
- 分页配置
- 错误响应结构
- 速率限制策略
要求
- HTTP 协议知识
- RESTful 架构理解
- JSON 数据处理