openapi - OpenAPI 规范(OAS 3.x)文档结构与使用指南。
提供编写、阅读、定义与校验 OpenAPI 规范(OAS 3.x)REST API 文档的规则与范例。
标签
更新于: 2026-09-20能力
典型输入
典型输出
该技能可以做什么
- 创建 OpenAPI 规范文档
- 描述 HTTP API 端点
- 定义请求与响应 Schema
- 配置 API 安全方案
- 校验现有 OpenAPI 文档
- 生成客户端或服务端代码
输入
- OpenAPI 规范文件
- API 端点定义
- 数据 Schema 定义
- 安全需求配置
输出
- OpenAPI JSON 或 YAML 文件
- 已校验的 OpenAPI 规范文档
- 生成的客户端或服务端代码
要求
- OpenAPI Specification 3.x 支持
- JSON 或 YAML 解析器
