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

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

Postman使用

Postman是一款非常好用的接口调试工具,界面漂亮且功能强大,对Postman不了解的可以看下《Postman:API接口调试利器》。

Swagger结合Postman使用

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

Swagger API导入Postman

  • 首先我们需要启动使用了Swagger的应用项目,这里以之前的mall-tiny-swagger项目为例子,找到api-docs路径,访问地址:http://localhost:8088/swagger-ui/

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第1张图片
  • 什么是Swagger的api-docs访问路径?该路径会返回JSON格式数据,应用中Swagger渲染API文档页面的所有数据就是来源于此,Postman也是可以通过这些数据来渲染API文档页面,这里的api-docs地址为:http://localhost:8088/v2/api-docs

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第2张图片
  • 在postman中点击import按钮,选择Link,输入Swagger的api-docs路径即可将Swagger生成的接口导入到Postman中去了;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第3张图片
  • 直接使用默认选项导入即可,无需修改;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第4张图片
  • 导入成功后,Swagger中的接口就会出现在Postman中了,之后就只需要在Postman中改改参数就可以开始调试接口了,是不是很方便!

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第5张图片

Postman设置环境变量

  • 我们随意找个接口访问下,会发现访问出错了,那是因为baseUrl这个环境变量设置有问题,导致了接口无法访问;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第6张图片
  • 我们只要在Postman中设置baseUrl这个环境变量,就可以正常访问了;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第7张图片
  • 添加好环境变量之后,需要选择好环境才会被应用。

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第8张图片

访问需要登录认证的接口

  • 这时候再次访问接口会发现我们的接口需要登录认证才能正常访问;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第9张图片
  • 我们可以先调用登录接口来获取Token;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第10张图片
  • 给需要登录认证的接口添加Bearer Token类型的Token,我们可以发现需要配置一个叫token的环境变量;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第11张图片
  • 在环境变量中添加token

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第12张图片
  • 添加完环境变量后即可正常访问需要登录认证的接口了。

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第13张图片

有何缺点

此种方法使用Postman来调试接口是非常强大的,但是对于文档展示能力有点偏弱。

  • 比如说Swagger中的接口对于请求和返回参数都有非常完善的注释信息;

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第14张图片
  • 而在Postman中,这些文档信息得不到体现,Postman毕竟还只是一个接口调试工具。

Swagger界面丑、功能弱怎么破?用Postman增强下就给力了!_第15张图片

总结

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

项目源码地址

https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-swagger

推荐阅读

  • 一线城市程序员VS三线城市程序员,该选哪个?

  • IntelliJ IDEA如果这样设置,使用起来贼顺手!

  • 还在百度Docker命令?推荐一套我用起来特顺手的命令!

  • mall-swarm微服务电商系统如何部署?用Jenkins自动化部署是真的香!

  • 看看人家那后端API接口写得,那叫一个优雅!

  • MySQL如何实时同步数据到ES?试试这款阿里开源的神器!

  • 为何程序员上班时间总戴个耳机,看完恍然大悟...

  • 还在手动整合Swagger?Swagger官方Starter是真的香!

  • 40K+Star!Mall电商实战项目开源回忆录!

  • mall-swarm 微服务电商项目发布重大更新,打造Spring Cloud最佳实践!


欢迎关注,点个在看

你可能感兴趣的:(java,接口,编程语言,web,html)