当需要将 OpenAPI 3.x 或 Swagger 2.0 规范（YAML 或 JSON）转换为完整、可直接导入的 Postman Collection v2.1 JSON 文件时使用此技能。每当用户提供或引用 OpenAPI 规范、Swagger 文件、openapi.yaml、swagger.json，或使用"转换我的 OpenAPI 规范"等表述时使用此技能。

将 OpenAPI 3.x 或 Swagger 2.0 规范转换为有效的 Postman Collection v2.1。

如果输入被截断或不完整，请转换可用的部分并注明缺失的章节。

paths.. 每个操作对应一个请求项

parameters（path/query/header） URL 路径变量、查询参数、请求头

requestBody.content.application/json.schema 请求体（原始 JSON），从模式生成示例

components.securitySchemes 集合级认证

parameters 查询/路径/请求头/请求体参数

consumes / produces Content-Type / Accept 请求头

对于每个带有 requestBody 或 body 参数的请求，从模式生成一个逼真的示例 JSON 请求体：

将安全方案映射到 Postman 认证：

http: basic 带 {{username}} / {{password}} 的 basic

apiKey: header 带 {{api_key}} 的 apikey 请求头

oauth2 oauth2（注意：需要手动设置令牌）

如果所有端点共享相同的方案，在集合级别应用认证。例外情况在请求级别覆盖。

使用标准的 v2.1 结构（与 postman-collection-generator 技能的模式相同）。

"response": [
  {
    "name": "200 OK",
    "status": "OK",
    "code": 200,
    "header": [{ "key": "Content-Type", "value": "application/json" }],
    "body": "{ \"id\": 1, \"name\": \"example\" }",
    "originalRequest": { <copy of the request> }
  }
]

将所有变量提取到配套的环境中：

交付 API 设计输出后，询问用户：

"您是否希望我为这个设计生成 API 文档？(是/否)"

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Postman Openapi Converter 实用指南

Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files. Use this skill whenever the user provides or references an OpenAPI spec, Swagger file, openapi.yaml, swagger.json, or uses phrases like "convert my OpenAPI spec",...

开发工具

后端

测试

本文提供Postman OpenAPI转换器完整操作指南，涵盖OpenAPI 3.x及Swagger 2.0规范转Postman Collection v2.1的步骤，包括字段映射、示例请求体生成、认证处理、环境变量提取及边缘情况处理，附质量检查清单，帮助开发者高效完成API规范转换。

服务器

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Postman Openapi Converter 实用指南

Postman Openapi Converter 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐