Swagger导出离线文档 接口文档

文章目录

  • 前言
  • 一、swagger.json获取
  • 二、json转换成文档
    • 1.转DOC
    • 2.转PDF、MARKDOWN
  • 三、转换结果


前言

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


 
直接跳过配置过程
 

一、swagger.json获取

 
方式一:可以通过点击http://localhost:8080/v2/api-docs获取。
 
Swagger导出离线文档 接口文档_第1张图片
 
但是操作项目所有分组访问对应/v2/api-docs都报404,才疏学浅不清楚原因直接使用第二种。
 
方式二:F12控制台获取响应json
 
Swagger导出离线文档 接口文档_第2张图片
 
Response的信息就是所有swager.json

 


 

二、json转换成文档

 

1.转DOC

 
通过 转换网站: 在线工具
 

2.转PDF、MARKDOWN

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


 

三、转换结果

 
eg:DOC文档
 
Swagger导出离线文档 接口文档_第3张图片

你可能感兴趣的:(JAVA,java,功能测试,文档资料)