如何将 Swagger 导入 Postman

将 Swagger 中的 API 定义导入到 Postman 中去,这样就可以利用 Postman 更强大的测试功能来测试 Swagger 定义的接口。

用 Apifox,节省研发团队的每一分钟

如何将 Swagger 导入 Postman

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

Swagger 和 Postman 都是常用的 API 测试工具,都有各自的优势。为了结合两者的优点,我们可以考虑将 Swagger 中的 API 定义导入到 Postman 中去,这样就可以利用 Postman 更强大的测试功能来测试 Swagger 定义的接口。


下面将以 Swagger Petstore 开源项目为例,介绍如何将 Swagger 导入到 Postman 中,以便后续进行更可观的接口测试。

导出 JSON 文件

Swagger Petstore 开源项目,点击 swagger.json 文件,鼠标右键,将其存到电脑本地,如下图所示,这会下载一个 JSON 格式的文件。

将 Swagger 导入 Postman
Swagger Petstore 开源项目导出 JSON 文件

导入 Postman

打开 Postman 应用,选择一个集合空间,点击导入按钮,将文件上传。

将 Swagger 导入 Postman
Postman 导入 Swagger 文件


将刚才下载的 OpenAPI 规范文件(JSON 文件)上传或输入文件链接地址。 Postman 会自动解析该文件并生成相应的请求集合和环境,检查导入的请求是否正确,可以对请求进行必要的修改。

将 Swagger 导入 Postman
Postman 导入 Swagger 文件


这样就可以直接在 Postman 中发送这些 API 请求了。

将 Swagger 导入 Postman
Postman 发起请求

如果 Swagger 文档有更新,也可以重新导出 OpenAPI 文件并导入到 Postman 来更新。主要利用 Postman 支持导入 OpenAPI 规范的功能,直接读取 Swagger 导出的文件,这样可以快速地将 Swagger 中的接口导入到 Postman 进行测试。

比 Postman 更好用的工具

Postman 打开会非常慢,而且会有一定的安全隐患,所以我更推荐使用 Apifox。Postman 有的功能它都有,它还免费的,支持中英文,简直完美。

什么是 Apifox?

Apifox 是一个比 Postman 更强大的接口测试工具,Apifox = Postman + Swagger + Mock + JMeter,Apifox 支持调试 http(s)、WebSocket、Socket、gRPC、Dubbo 等协议的接口,并且集成了 IDEA 插件。在开发完接口后,可以通过 Apifox 的 IDEA 插件一键生成接口文档,多端同步,非常方便测试和维护。

Apifox

将 Swagger 文件导入 Apifox

打开 Apifox,创建一个项目后,选择“项目设置->导入数据->OpenAPI/Swagger->文件导入”,将已导出的 Swagger 格式的 JSON 文件导入即可。

将 Swagger 文件导入 Apifox
将 Swagger 文件导入 Apifox

导入时,会有预览,可以选择导入全部,也可以选择性的导入接口。

Apifox 选择性的导入接口
Apifox 选择性的导入接口

导入成功之后,你可以选择一个环境来测试接口。如下图所示,接口成功返回数据:

将 Swagger 导入 Postman
Apifox 测试接口


Postman 只是解决了 API 开发中的一小部分问题,Apifox 是更全面的一体化工具,越来越多的开发者开始选择 Apifox 替代 Postman。工具适合自己才是最重要的,赶紧来试试 Apifox

Apifox
Apifox

知识扩展: