Swagger文档转Word 文档
GitHub 地址:https://github.com/JMCuixy/SwaggerToWord
原创作品,转载请注明出处:Swagger文档转Word 文档 - JMCui - 博客园
一、前言
为什么会产生这个需求呢?
我们公司作为乙方,老是被客户追着要一份API文档,当我们把一个 Swagger 文档地址丢给客户的时候。客户还是很不满意,嫌不够正式!!死活坚持要一份 word 文档 。然后领导给了个接口模板,就把这个活交给我了......我去,近10个微服务,几百个接口,这不得要了我的命啊(最后整理出来将近200页的 word 文档)。最后,还是领导有办法:要不我们把Swagger的 json文件转成word文档吧!
一直坚持一句话。作为使用者,人要迁就机器;作为开发者,要机器迁就人。
二、思路
领导提供了一个接口模板,类似下面这样,其实就是一个word的table页。想到 html 可以转 word ,那么问题就变成了 :
1、解析JSON 文件
2、把JSON文件的内容填充进htm