【Java】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
这个环境变量,就可以正常访问了;
点击add:
- 添加好环境变量之后,需要选择好环境才会被应用。
- 这时候再次访问接口
总结
Swagger和Postman结合使用比较好,Swagger用来看接口文档信息,Postman用于调试,将Swagger中的接口导入到Postman中可以弥补Swagger在接口调试方面的不足。
以上是 【Java】Swagger界面丑、功能弱怎么破?用Postman增强下就给力了! 的全部内容, 来源链接: utcz.com/a/94795.html