api-design - 设计一致的 REST API
按照行业最佳实践设计一致、可预测的 REST API
标签
更新于: 2026-05-09能力
典型输入
典型输出
该技能可以做什么
- 设计 REST API 资源
- 定义 HTTP 方法
- 返回状态码
- 格式化错误响应
- 实现分页
- 版本化 API 端点
- 创建 FastAPI 路由
- 配置依赖注入
- 添加错误处理中间件
- 创建健康检查
输入
- API 需求
- 资源定义
- 用例逻辑
- 领域模型
输出
- REST API 设计
- API 端点
- 错误响应结构
- 健康检查路由
要求
- FastAPI 框架
- Pydantic 模型
- 数据库连接
- HTTP 服务器
