关于前端: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 在接口调试方面的有余。