SuperAPI AI 工具集

postman-openapi-converter

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:把 OpenAPI 3.x 或 Swagger 2.0 规范(YAML 或 JSON)转换为完整、可直接导入的 Postman Collection v2.1 JSON,并生成配套环境文件。

主要能力:识别规范版本(openapi: 3.x.x 或 swagger: "2.0");将 info.title/description 映射为集合名称与描述,servers[0].url 或 host+basePath 映射为 {{base_url}} 变量;每个 path+method 生成一个请求项,按 tags 分组为文件夹;映射 path/query/header 参数、请求体与响应;根据 schema 生成示例 JSON 请求体(如 email 格式生成 user@example.com,date-time 生成 2024-01-15T10:30:00Z),并内联解析 $ref;将 securitySchemes 映射为 Postman 认证(bearer 用 {{token}}、basic 用 {{username}}/{{password}}、apiKey 用 {{api_key}}、oauth2 需手动配置令牌);保存示例响应;输出 collection.json、environment.json 及转换摘要(端点数量、文件夹、认证类型、跳过或近似的字段)与导入说明。

使用方式:提供规范文件或内容即可触发转换;输出为两个 JSON 文件,按摘要中的导入说明导入 Postman。

限制与边界:输入被截断时仅转换可用部分并标注缺失;allOf/oneOf/anyOf 取首个主 schema 生成请求体并在描述中注明备选;多内容类型优先 application/json;无 operationId 时按 METHOD /path 生成名称;路径参数在 URL 中转为 :param 并加入变量数组;认证令牌一律使用变量,不硬编码。完成后会询问是否生成 API 文档,若对应技能未安装则提示安装后重跑。具体收费、平台支持等信息暂未提供。