无法将 swagger JSON 或 YAML 导入 Postman

Posted

技术标签:

【中文标题】无法将 swagger JSON 或 YAML 导入 Postman【英文标题】:Unable to import swagger JSON or YAML into Postman 【发布时间】:2018-08-02 10:38:01 【问题描述】:

问题

无法将 swagger 2.0 转换为受 Postman 导入功能影响的格式

通过/swagger.json|yaml生成

使用 swagger 通过 dropwizard jetty 暴露的 Swagger 端点

swagger-core:1.5.17 swagger-jaxrs:1.5.17 swagger-jersey2-jaxrs: 1.5.17 招摇模型:1.5.17

尝试

尝试通过导入屏幕手动导入 JSON 或 YAML 版本

导入文件 从链接导入 粘贴原始文本

尝试使用 api-spec-converter 和 swagger2-postman-generator 转换为不同的格式

结果

导入错误:Must contain an info object

问题

有没有人设法解决这个问题,允许导入

【问题讨论】:

【参考方案1】:

在 Swagger 2.0 中,信息字段是强制性的。只需将以下内容添加到您的 YAML 根目录:

info:
  title: 'EmptyTitle'
  description: 'EmptyDescription'
  version: 0.1.0

或者如果你有 JSON 格式(在根目录中),也可以这样:

"info": 
  "title": "EmptyTitle",
  "description": "EmptyDescription",
  "version": "0.1.0"

希望对您有所帮助!

【讨论】:

谢谢,添加到原始json脚本后,效果很好【参考方案2】:

您是否尝试过转换为 Postman v2?

您尝试的 swagger2-postman-generator 将 Swagger v2 转换为 Postman v1。这个将 Swagger v2 转换为 Postman v2:https://www.npmjs.com/package/swagger2-postman2-converter,如 this tutorial 中所用。

【讨论】:

它已经是版本 2 格式,正如我在帖子中提到的那样...... BBerastegui 找到了诀窍(y)

以上是关于无法将 swagger JSON 或 YAML 导入 Postman的主要内容,如果未能解决你的问题,请参考以下文章

将 Swagger JSON 转换为 RAML/YAML

从命令行将 Swagger YAML 文件转换为 JSON

如何使用 YAML 文件在 Spring Boot 中配置 Swagger?

使用play-swagger存储库无法在localhost中看到swagger json

pytest + yaml 框架 -19.根据 swagger.json 自动生成 yaml 格式自动化用例

如何从 protobuf (.proto) 文件中生成 (.json/.yaml) 中的 swagger3 (OpenAPI3) 规范?