程序对于API文档一直是一个折磨的事情,写完了api还要对着实体,把属性一个一个地复制粘贴到word。相信你一定也有过一段这样的经历。这个问题可以通过很多途径解决,我目前知道的,推荐的有两个,一个是swagger,一个就是今天说的ApiPost。你可能在用postman,它也可以生成接口文档,但是比较丑陋。对已有的文档可以导出JSON文件到ApiPost中。
postman 导出接口文档
打开postman,在页面左侧,选择collection选择导出(export)
导入postman json到ApiPost
生成api文档
文档案例
文档包含了请求头、参数及注释、请求连接,整体内容比较符合预期