engineer-api-design - 专业 REST API 架构设计
设计、创建、审查及编写规范、安全且结构清晰的 REST API 端点与 Schema。
标签
更新于: 2026-09-19能力
典型输入
典型输出
该技能可以做什么
- 定义领域资源
- 映射 HTTP 方法与操作
- 设计请求与响应 Schema
- 构建 REST 资源 URL
- 实现幂等请求处理
- 生成 OpenAPI 文档
输入
- API 需求与规范
- Schema 与基础设施参考文件
- 幂等性请求头
输出
- 标准化 HTTP JSON 响应 Envelope
- Zod 请求与响应 Schema
- OpenAPI 文档
- Serverless 函数路由处理代码
要求
- Serverless 或 HTTP 服务运行环境
- Zod Schema 校验库