Swagger生成word文档

前言:

最近工作中需求,需要利用mybatis-plus代码生成器生成的做成一个接口文档给客户

一、生成word接口文档

原理:swagger本身返回的就是json数据,所以你把你项目的json数据放到下面的项目里,它就可以格式化数据了。下面将要下载的项目就是用来处理这个json数据的,支持word导出。

1. 下载这个项目,用来生成文档的

百度链接:https://pan.baidu.com/s/1b8JnD82–8hmeejM_MS9cA
提取码:qmm2
2. 下载完成后打开项目,可以直接运行的,先访问一下,返回hello Swagger2word!即成功!
Swagger生成word文档_第1张图片
3. 运行我们需要导出接口文档的服务,http://localhost:8121/v2/api-docs我的是这样,后面的/v2/api-docs解释如下图:
Swagger生成word文档_第2张图片
4. 我们把这个地址复制到生成项目的配置文件里
Swagger生成word文档_第3张图片
5. 重新启动项目,访问locaohost:8080/toWord
Swagger生成word文档_第4张图片
6. 下载文档,即可成功

你可能感兴趣的:(实际项目)