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

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

导出 JSON 文件

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

简易教程:将 Swagger 导入 Postman_JSON

导入 Postman

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

简易教程:将 Swagger 导入 Postman_Postman_02

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

简易教程:将 Swagger 导入 Postman_Postman_03

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

简易教程:将 Swagger 导入 Postman_程序员_04

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

如果你需要全中文工具

Postman 有时候打开会非常慢,而且是全英文的,或许你可以试试 Apifox。Postman 有的功能它都有,它还免费的,支持中英文,简直完美。

将 Swagger 文件导入 Apifox

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

简易教程:将 Swagger 导入 Postman_API_05

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

简易教程:将 Swagger 导入 Postman_程序员_06

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

简易教程:将 Swagger 导入 Postman_swagger_07

知识扩展: