OpenAPI 2 到 3 版本转换器

OpenAPI 2 到 3 版本转换器

粘贴一个 Swagger 2.0 规范，即可获得一个有效的 OpenAPI 3.0.3 版本，格式可为 JSON 或 YAML。转换器会应用官方结构映射规则——将 definitions under components/schemas合并 host, basePath，并且 schemes 进入 servers拆分 consumes 且 produces 转换为每个操作的 content 映射，并重新设计表单参数和安全定义——以确保您的规范能够与现代 OpenAPI 工具兼容。

如何使用

1. 将您的 Swagger 2.0 规范粘贴到输入框中。支持 JSON 和 YAML 格式，格式将自动检测。
2. 选择输出格式：保持输入格式，或强制输出为 JSON 或 YAML。
3. 离开 补全缺失的必填字段 以自动填充 v3 中的必需字段，如 info.title, info.version，以及当 v2 源规范省略响应描述时补全缺失的响应描述。
4. 阅读转换摘要和上方显示的任何警告，然后复制或下载生成的 OpenAPI 3.0.3 规范。

特征

• 输入为 JSON 或 YAML，输出为 JSON 或 YAML ——选择您偏好的格式，或与输入格式保持一致。
• 结构映射 — definitions → components/schemas, securityDefinitions → components/securitySchemes, parameters/responses 被移入 components，并且每个 $ref 指针都会被重写以匹配。
• 来自 host、basePath、schemes 的服务器 ——合并为 v3 的 servers 数组，当存在多个协议时优先选择 HTTPS。
• 内容协商 — consumes 且 produces 被转换为每个操作的 requestBody.content 且 responses[*].content 映射。
• 请求体和表单参数 — in: body 变为 v3 requestBody，并且 in: formData 字段被归入一个 multipart/form-data 或 application/x-www-form-urlencoded 请求体模式。
• 安全流程升级 ——OAuth2 flow 值被重新映射到 v3 flows 对象（implicit, password, clientCredentials, authorizationCode).
• 补丁模式 ——当启用时，会填充缺失的必填字段，使输出通过 v3 验证器，而不是在源规范的微小缺陷上失败。
• 转换摘要和警告 ——统计转换的路径、模式和安全方案数量，以及无法一一映射的任何警告。
• 完全在浏览器中运行 ——您的规范不会离开页面。