# OpenAPI 转 Postman Collection 把 OpenAPI 3.x 或 Swagger 2.0 规范（JSON/YAML）转成可直接导入的 Postman Collection v2.1.0，含文件夹、变量、认证与示例响应。 > 标准页面: https://elysiatools.com/zh/tools/openapi-to-postman-collection - **分类:** Development - **关键词:** openapi 转 postman, swagger 转 postman, postman 导入, openapi 转换器, api 测试, newman ## 概述 粘贴规范、下载集合、在 Postman（Import → File）导入或用 Newman 运行——无需本地安装任何 Node 包。转换遵循 Postman 官方 openapi-to-postman 约定：servers[0] 生成 {{baseUrl}} 集合变量（尾部斜杠剥除，多余 server 存为 baseUrl_2…，{port} 等服务器变量转为集合变量）；路径策略构建可折叠的路径前缀树（或改用 tags 分夹）；路径参数变成 :param 段 + url.variable；query/header 参数描述带 “(Required) ” 前缀与枚举提示；JSON 请求体用确定性样本值生成（example → 首个枚举 → default → 按 format → user@example.com 之类的属性名启发式）；每个状态码保存示例响应；bearer/basic/apiKey 安全方案转为集合认证并引用 {{bearerToken}}/{{apiKey}} 变量。Swagger 2.0 经兼容层转换。Cookie 参数会被丢弃并给出警告（Postman 集合无法表达）。 ## 输入项 - **OpenAPI / Swagger 规范（JSON 或 YAML）** (textarea): { "openapi": "3.0.3", "info": { "title": "My API" }, … - **文件夹策略** (select) - **包含示例响应** (checkbox) - **把安全方案转换为认证配置** (checkbox) ## 适用场景 - 后端提供 OpenAPI 或 Swagger 文档后，需要快速在 Postman 中构建完整的接口测试集合与目录。 - 需要将接口规范导出为标准集合文件，以便通过 Newman 接入 CI/CD 流水线执行接口自动化测试。 - 希望自动映射接口的鉴权方案（Bearer、Basic、API Key）、路径参数和确定性 Mock 请求体，避免手动录入。 ## 工作原理 - 粘贴 OpenAPI 3.x 或 Swagger 2.0 规范的 JSON 或 YAML 文本。 - 选择文件夹组织策略（按路径前缀或按 Tags 标签），并按需勾选是否包含示例响应与认证方案转换。 - 系统解析 servers、路由、参数与 Schema，自动生成 {{baseUrl}} 集合变量、路径参数变量及确定性请求体样本。 - 下载生成的 Postman Collection v2.1.0 JSON 文件，直接在 Postman 中通过 Import 导入使用。 ## 使用案例 - 接口联调与测试：快速将后端导出的 Swagger 规范转为 Postman 集合，开箱即用发起接口调用。 - CI/CD 流水线集成：自动化生成标准集合文件并通过 Newman 命令行工具执行回归测试。 - 前端 Mock 数据联调：基于规范生成的确定性请求体和响应示例，快速开展前后端并行开发与调试。 ## 常见问题 ### 支持哪些版本的 API 规范文件？ 支持 OpenAPI 3.0.x、3.1.x 以及通过兼容层解析的 Swagger 2.0 规范，格式支持 JSON 与 YAML。 ### 规范中的 Base URL 如何映射到 Postman 中？ 规范中首个 server 地址会转为集合变量 {{baseUrl}} 并去除尾部斜杠，多余的 server 会依次存为 baseUrl_2 等变量。 ### 支持哪些类型的接口安全方案（Auth）转换？ 支持将 Bearer Token、Basic Auth 和 API Key 安全方案转为集合级认证，并自动关联 {{bearerToken}} 或 {{apiKey}} 变量。 ### 为什么 OpenAPI 中的 Cookie 参数没有出现在集合请求中？ 由于 Postman Collection 格式规范本身无法表达 Cookie 参数，转换时 Cookie 参数会被忽略并附带提示。 ### 文件夹策略中“按路径”与“按标签”有什么区别？ “按路径”会根据 URL 路径前缀构建折叠树（Postman 默认），“按标签”则依据接口定义的 tags 属性对请求进行归类分组。 ## 相关工具 - [环境配置差异可视化器](https://elysiatools.com/zh/tools/environment-config-diff-visualizer): 对 JSON、YAML、TOML 与 ENV 配置进行跨环境对比，高亮漂移项、缺失项，并给出清洗建议。 - [OpenAPI 转 TypeScript 类型生成器](https://elysiatools.com/zh/tools/openapi-to-typescript-generator): 将 OpenAPI 或 Swagger 的 JSON/YAML 规范转换为 TypeScript 接口类型、请求参数类型和响应类型，并支持输出格式与命名风格配置 - [图片调色板转设计令牌](https://elysiatools.com/zh/tools/image-to-design-tokens): 从图片中用 k-means 聚类提取主色，导出为 CSS 变量 / SCSS 变量 / Tailwind 配置 / JSON 设计令牌，并自动为每个颜色生成命名色阶 - [范围图生成器](https://elysiatools.com/zh/tools/range-chart-generator): 创建范围图来可视化最小值-最大值范围，支持中位数标记和异常值检测 - [JSON Schema 转 Zod Schema 转换器](https://elysiatools.com/zh/tools/json-schema-to-zod-schema-converter): 将标准 JSON Schema 的 JSON/YAML 定义转换为可直接在 TypeScript 项目中使用的 Zod 运行时校验代码，支持嵌套结构、数组、枚举和常见校验规则 - [PDF二维码条码标签](https://elysiatools.com/zh/tools/pdf-qr-barcode-labels): 批量生成包含二维码/条形码的标签PDF - [BOM字符移除器](https://elysiatools.com/zh/tools/data-bom-remover): 从文本和文件内容中移除BOM（字节顺序标记）字符。非常适合清理有编码问题的文本文件、修复CSV导入和为处理准备数据。 功能特点： - 检测并移除UTF-8 BOM (EF BB BF) - 检测并移除UTF-16 BOM (FE FF 或 FF FE) - 检测并移除UTF-32 BOM (00 00 FE FF 或 FF FE 00 00) - 支持多种输入格式 - 可视化BOM字符显示 - 详细检测报告 - 支持批量文本处理 常见用途： - 修复CSV文件导入错误 - 清理文本文件编码问题 - 为JSON解析准备数据 - 修复XML解析问题 - 解决API数据编码冲突 - 标准化文本数据格式 - [数据范围限制器](https://elysiatools.com/zh/tools/data-range-limiter): 将数值限制在指定范围内，通过裁剪、过滤或标记越界值。完美用于数据质量控制、传感器数据清洗、业务规则执行和数据预处理。 功能特点： - 范围裁剪（将值裁剪到最小/最大边界） - 范围过滤（移除越界行） - 范围标记（标记修改的值） - 每列范围配置 - 自动数值列检测 - 多种处理策略 - 详细修改报告 - 变更统计分析 - 业务规则执行 常见用途： - 传感器数据验证和清洗 - 机器学习输入准备 - 数据质量控制和验证 - 业务约束执行 - 异常值管理和控制 - 数据预处理管道 ## 示例 - [OpenAPI/Swagger 示例](https://elysiatools.com/zh/samples/openapi-swagger): 使用 OpenAPI 3.0 和 Swagger 规范的 RESTful 服务综合 API 文档示例 - [分布式追踪示例](https://elysiatools.com/zh/samples/distributed-tracing-samples): 使用 Jaeger、OpenTelemetry 和其他现代可观测性工具的综合分布式追踪示例，适用于微服务架构 - [Parcel 打包工具](https://elysiatools.com/zh/samples/parcel): Parcel零配置打包工具示例，包括项目设置、插件和高级配置 - [pnpm 包管理器示例](https://elysiatools.com/zh/samples/pnpm): 快速、节省磁盘空间的包管理器示例，包括monorepo管理、工作区配置和高级工作流 ## 相关内容 - [JSON 交换与格式翻译工具](https://elysiatools.com/zh/hubs/json-convert): 在一个专题里比较 JSON 与 CSV、YAML、TOML、GraphQL、XML、Markdown、Excel、BSON、EDN 等结构化格式之间的转换工具。 - [JSON 检查、对比与转换工具](https://elysiatools.com/zh/hubs/json-utility): 把 JSON 格式化、差异对比、路径检查、Schema 校验、合并、转换和导出工具集中到一个专题中，适合 API 与数据处理流程。 - [JSON Schema、Mock 数据与 API 夹具生成工具](https://elysiatools.com/zh/hubs/json-generate): 围绕JSON Schema 生成、Mock 负载构建与 API 夹具准备整理的一组工具。 - [JSON 格式化、对比与规范化工具](https://elysiatools.com/zh/hubs/json-format): 在一个专题中比较 JSON 格式化、差异对比、日志审查、配置比较和数据规范化工具，适合需要让 JSON 更易读、更易审查的流程。