Postman Collection 转 Swagger
将 Postman Collection v2.1 导出文件转换为 OpenAPI 3.0 规范
支持 Collection v2.0 / v2.1 格式
关于 Postman Collection
- Postman 是最流行的 API 调试工具,Collection 文件(.json)保存了接口请求的完整信息
- 转换为 OpenAPI 3.0 规范后,可接入 Swagger UI 展示文档、使用 OpenAPI Generator 生成客户端 SDK
- 也可导入到 Apifox、Apipost 等国内 API 管理平台
- 转换时自动提取:请求路径、HTTP 方法、Headers、Query 参数、Body 结构和示例数据
操作说明
- 在 Postman 中:Collection → 右键 → Export → 选择 Collection v2.1 格式导出
- 将导出的 JSON 文件内容粘贴到左侧输入框,点击「转换」
- 支持拖拽
.json文件直接上传 - 转换结果可下载为
openapi.json或复制后导入其他工具 - 快捷键:Ctrl + Enter 执行转换
注意事项
- 仅支持 Collection v2.0 / v2.1 格式,旧版 v1.0 格式不兼容
- Postman 变量(如
{{baseUrl}})会自动转换为 OpenAPI 路径参数格式{baseUrl} - 转换结果为基础 OpenAPI 骨架,复杂的响应 Schema 需手动补充
- 所有数据在浏览器本地处理,不会上传到服务器