首页

Swagger转Postman

在线Swagger转Postman工具，将Swagger/OpenAPI JSON规范一键转换为Postman Collection集合，自动解析接口路径、请求方法、参数与请求体，生成可直接导入Postman的Collection JSON。支持粘贴JSON或URL加载，适用于API调试、接口测试与团队协作。

转换次数
0
成功次数
0
失败次数
0
接口数
0
Swagger/OpenAPI 规范
Postman Collection 结果
转换后的 Postman Collection JSON 将显示在此处...
输入 Swagger JSON 或 URL 后点击「转换为Postman集合」

功能特性

一键转换

将Swagger 2.0 / OpenAPI 3.0规范一键转换为Postman Collection v2.1格式，自动解析paths、methods、parameters、requestBody。

URL与JSON双输入

支持粘贴Swagger JSON内容，或填写在线文档URL由后端下载转换，满足公开文档与内网私有API两种场景。

结构化集合

按接口路径与Tag自动组织成层级化的Collection文件夹结构，导入Postman后清晰易用，便于分组管理。

参数自动填充

自动识别Path/Query/Header参数并填入请求配置，请求体（JSON）自动写入Body，减少手动配置工作量。

复制与下载

转换结果支持一键复制到剪贴板，或下载为postman_collection.json文件，直接导入Postman即可使用。

JSON语法高亮

结果区对键名、字符串、数字、布尔值等做轻量语法高亮，层级清晰，便于阅读与检查转换正确性。

使用说明

如何使用Swagger转Postman工具？

  • 切换「粘贴 JSON」标签，直接粘贴 Swagger/OpenAPI 规范全文；或切换「从 URL 加载」标签填写在线文档地址。
  • 点击「示例」按钮可快速填充一份示例 OpenAPI 3.0 JSON，便于体验转换效果。
  • 点击「转换为Postman集合」按钮，后端调用转换服务生成 Postman Collection JSON。
  • 结果区显示转换后的 Collection（带语法高亮），可点击「复制」或「下载JSON」保存为 postman_collection.json。
  • 打开 Postman → Import → 选择下载的 JSON 文件，即可导入为可用的 Collection。

导入Postman的步骤

  • 下载转换后的 postman_collection.json 文件到本地。
  • 打开 Postman 客户端，点击左侧 Collections 面板顶部的 + Import 按钮。
  • 在导入窗口选择 File 方式，拖入或选择下载的 JSON 文件。
  • Postman 会识别为 Collection v2.1 格式，点击 Import 完成导入。
  • 导入后可在 Collection 中看到所有接口，按需设置环境变量（如 baseUrl、token）后即可发起请求。

典型使用场景

  • 接口调试：将后端Swagger文档转为Postman集合，快速逐个调试接口。
  • 团队协作：把生成的Collection JSON共享给前端/测试同学，统一接口调用规范。
  • 自动化测试：导入Postman后通过Newman命令行批量执行接口测试。
  • API文档预览：通过Postman的文档功能生成可分享的在线API文档。
  • 历史规范迁移：将遗留Swagger 2.0文档转为Postman集合，统一到现代API测试工作流。

常见问题

支持哪些Swagger/OpenAPI版本？
支持 Swagger 2.0（含 swagger: "2.0" 字段）与 OpenAPI 3.0/3.1（含 openapi: "3.x.x" 字段）两种规范。工具会自动识别规范结构并转换为对应的 Postman Collection v2.1 格式。建议优先使用 OpenAPI 3.0，其对请求体、响应内容的描述更完整。
转换失败提示"无效的Swagger JSON格式"怎么办？
该错误表示输入的内容不是合法的 JSON，或缺少 Swagger/OpenAPI 必要字段。请：1）确认 JSON 语法正确（可用 JSON 校验工具检查，注意逗号、引号、括号匹配）；2）确认根节点包含 openapi 或 swagger 字段及 paths 对象；3）若使用URL方式，确认URL可公开访问且返回的是JSON规范内容。规范的 info、paths 为必填字段。
URL加载和JSON粘贴有什么区别？
URL加载：填写Swagger文档的在线地址（如 https://petstore.swagger.io/v2/swagger.json），后端主动下载该文件再转换，适合公开可访问的API文档。JSON粘贴：直接粘贴规范全文，适合内网私有API（URL无法公网访问）、本地开发中的规范文件、或需要临时修改规范的场景。两种方式转换结果完全一致。
转换后的Collection如何设置请求基地址（baseUrl）？
转换后的请求URL通常使用规范中 servers（OpenAPI 3）或 host + basePath（Swagger 2）定义的地址。导入Postman后建议创建环境变量（如 baseUrl）统一管理基地址，便于在开发/测试/生产环境间切换。如规范未定义服务器地址，需在Postman中手动补充完整URL。
转换后接口的参数和请求体会自动填充吗？
会自动填充。工具会解析规范中的 Path 参数（如 /pets/{petId}）、Query 参数、Header 参数并写入对应请求配置；请求体（requestBody，application/json）会自动填入Postman的Body（raw JSON）并生成示例结构。部分复杂Schema可能生成示例占位值，实际使用时按需替换。
本工具是免费的吗？规范数据会被存储吗？
完全免费，无需注册登录。转换在服务器内存中完成，不会持久化存储任何Swagger规范内容。URL方式下规范文件经服务器中转下载并立即用于转换，转换完成后即释放。涉及高度敏感的私有API建议使用JSON粘贴方式，并先对敏感字段脱敏。