api-schema - 使用 OpenAPI 设计 API 架构
定义请求/响应格式、版本控制、验证规则和兼容性策略
标签
更新于: 2026-03-20能力
典型输入
典型输出
该技能可以做什么
- 创建 OpenAPI 规范
- 定义可重用模式
- 分类变更
- 选择版本策略
- 从规范生成代码
- 添加请求验证
- 设计 REST API
- 添加端点
- 生成客户端 SDK
- 生成服务器桩代码
- 记录 API
- 验证规范
输入
- OpenAPI 规范
- JSON Schema
- 服务名称
- API 资源
- 请求参数
- 用户数据
- 错误结构
- 版本策略
输出
- OpenAPI 文件
- 客户端 SDK
- 服务器桩代码
- API 文档
- 验证错误
- 差异报告
要求
- OpenAPI 3.1 规范
- 代码生成工具
- CI 验证环境