Swagger2与Postman最佳实践

3,363 阅读1分钟

使用Swagger2可以比较方便的生成API文档,并测试接口,但是体验相比Postman差太多且无法保存,好在可以将swagger数据导入到Postman,下面将演示如何将导入

将Swagger数据导入到Postman

项目运行后,可以直接访问/v2/api-docs路径,我们只需要将这个路径导入Postman,就可以生成Collections,如下图所示:

导入到Postman

Swagger2与Postman结合使用的关键在于指定正确的paramType,其提供了五种类型:form query body path header 只有指定了正确的类型,导入到Postman时其才能正确识别将值设置在何处,更多例子文章底部的项目中,如下是指定为path时生成的接口

path参数

问题

Swagger2导入后会自动生成baseUrl变量,变量值为//host:port/我们需要对其更改,否则最终请求时会变成http:////host:port/导致请求失败, 点击Collection -> Edit -> Variables进行修改!

修改环境变量

其他

相关代码在Swagger2最佳实践