Swagger导出离线文档 接口文档

9,755 阅读1分钟

前言

需要将Swagger接口文档信息导出成离线文档形式,看了很多文章都使用swagger2markup导出,尝试过程中不是插件依赖没加载就是mvn命令一堆错误,最终直接放弃,使用投机取巧的方式----swagger.json转换成文档,由此记录一下。


  直接跳过配置过程  

一、swagger.json获取

  方式一:可以通过点击http://localhost:8080/v2/api-docs获取。

  在这里插入图片描述  

但是操作项目所有分组访问对应/v2/api-docs都报404,才疏学浅不清楚原因直接使用第二种。  

方式二:F12控制台获取响应json  

在这里插入图片描述  

Response的信息就是所有swager.json  


 

二、json转换成文档

 

1.转DOC

  通过 转换网站: 在线工具  

2.转PDF、MARKDOWN

  通过 转换网站:DOCWAY 导入项目后就可以进行转换


 

三、转换结果

  eg:DOC文档  

在这里插入图片描述