在使用Swagger的时候,你是否会有这种感觉:提交参数为JSON没法格式化,参数错了查找麻烦,返回结果没法折叠,太长了没法看!Swagger结合Postman使用后这一情况有很大改变,今天我们来讲下如何使用Postman增强Swagger的功能,希望对大家有所帮助!
Postman是一款非常好用的接口调试工具,界面漂亮且功能强大,对Postman不了解的可以看下《Postman:API接口调试利器》。
下面介绍下如何将Swagger API导入到Postman中去,然后使用Postman来调试接口。
mall-tiny-swagger
项目为例子,找到api-docs
路径,访问地址:http://localhost:8088/swagger-ui/api-docs
访问路径?该路径会返回JSON格式数据,应用中Swagger渲染API文档页面的所有数据就是来源于此,Postman也是可以通过这些数据来渲染API文档页面,这里的api-docs
地址为:http://localhost:8088/v2/api-docsimport
按钮,选择Link
,输入Swagger的api-docs
路径即可将Swagger生成的接口导入到Postman中去了;baseUrl
这个环境变量设置有问题,导致了接口无法访问;baseUrl
这个环境变量,就可以正常访问了;Bearer Token
类型的Token,我们可以发现需要配置一个叫token
的环境变量;token
;此种方法使用Postman来调试接口是非常强大的,但是对于文档展示能力有点偏弱。
Swagger和Postman结合使用比较好,Swagger用来看接口文档信息,Postman用于调试,将Swagger中的接口导入到Postman中可以弥补Swagger在接口调试方面的不足。
https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-swagger