Swagger界面丑、功能弱怎么破？用Postman增强下就给力了！

前言

本文引自：梦想de星空 macrozheng

在使用Swagger的时候，你是否会有这种感觉：提交参数为JSON没法格式化，参数错了查找麻烦，返回结果没法折叠，太长了没法看！Swagger结合Postman使用后这一情况有很大改变，今天我们来讲下如何使用Postman增强Swagger的功能，希望对大家有所帮助！

Postman使用

下面介绍下如何将Swagger API导入到Postman中去，然后使用Postman来调试接口。

Swagger API导入Postman

• 首先我们需要启动使用了Swagger的应用项目，找到api-docs路径，访问地址：http://localhost:8080/swagger-ui/

• 什么是Swagger的api-docs访问路径？该路径会返回JSON格式数据，应用中Swagger渲染API文档页面的所有数据就是来源于此，Postman也是可以通过这些数据来渲染API文档页面，这里的api-docs地址为：http://localhost:8080/v2/api-docs
• 在postman中点击import按钮，选择Link，输入Swagger的api-docs路径即可将Swagger生成的接口导入到Postman中去了；
  
• 直接使用默认选项导入即可，无需修改；

• 导入成功后，Swagger中的接口就会出现在Postman中了，之后就只需要在Postman中改改参数就可以开始调试接口了，是不是很方便！

Postman设置环境变量

• 我们随意找个接口访问下，会发现访问出错了，那是因为baseUrl这个环境变量设置有问题，导致了接口无法访问；
  
• 我们只要在Postman中设置baseUrl这个环境变量，就可以正常访问了；

• 添加好环境变量之后，需要选择好环境才会被应用。

• 这时候再次访问接口

总结

Swagger和Postman结合使用比较好，Swagger用来看接口文档信息，Postman用于调试，将Swagger中的接口导入到Postman中可以弥补Swagger在接口调试方面的不足。