大家好，我是小富~
前几天粉丝群有小伙伴问，有啥好用的API文档工具推荐，无意间发现了一款工具，这里马不停蹄的来给大家分享一下。
ShowDoc一个非常适合团队的在线API文档工具，也支持用docker自建文档服务，不过为了方便演示，我直接用了平台在线服务。官网地址：
https://www.showdoc.com.cn/item/index
可以使用markdown语法来写API文档、数据字典文档、技术文档、在线excel文档。但像我这种资深的懒人程序员，其实更看重的是showdoc的自动化生成文档的特性，它可以从代码注释中自动生成API文档，或者搭配RunApi客户端（类似postman的api调试工具）一边调试接口、一边自动生成文档。
下边从头演示下，来瞅瞅这玩意好用在哪？
初识 ShowDoc
ShowDoc新建项目可选常规的API文档、在线表格、或者单页文档（不支持目录分层），允许对项目文档设置访问密码，自定义域名，这里并不是真正意义上的“域名”，只是在文档服务域名后加了一级目录，例如：
www.showdoc.com.cn/程序员内点事
可以复制现有的项目，或直接导入Postman、swagger的API接口配置Json文件。提供的开放API是自动化生成文档的关键，先记住有api_key、api_token这两个属性，后边详细讲。
进入项目后点击右上角 + 编辑文档，ShowDoc预置了几种文档模板，也可以把自定义的文档存为模板；支持在线Mock服务，提前定义好接口的数据格式，先提供在线临时接口，这样就可以和前端同步开发，后边无缝切换；还有个简单的API在线测试功能。
在线表格样式很简洁。
导出文档有word、Markdown两种格式。
支持版本控制，能看到每次修改的记录，回滚任意一个版本的修改。
在向别人分享在线文档时，如果不想将整个API目录都暴漏，可以选择进行单页面分享。
看到这感觉showdoc很普通啊，好像没什么特别的地方，上边的这些文档都是需要我们手动书写的，比较繁琐不推荐这么搞，接下来咱们看看如何自动化生成文档。
自动生成文档
showdoc有三种自动生成API文档的方式：
· 使用Runapi工具自动生成（推荐）
· 使用程序代码注释自动生成
· 自动生成数据字典
· 自己写程序调用接口来生成
Runapi工具
Runapi是一个以接口为核心的开发测试工具（可以看做是Postman的精简版）。目前客户端支持win、mac、linux平台和在线版 ，包含接口测试、自动流程测试、Mock数据、项目协作等功能。
单纯的Runapi和Postman相比优势并不大，而与showdoc配合使用效率比较显著，用runapi测试接口的同时它将自动生成API文档到showdoc，也可共用showdoc的团队管理机制实现多人协作。
Runapi客户端可以创建带调试的API接口文档、或者Markdown格式的文档。
比如我们新建个项目“程序员内点事”，分别建三个接口“点在”、“在看”、“关注”，紧接着快速生成参数和响应结果数据并保存。
点击右上角的文档链接设置访问密码，不填默认是公开的，复制文档链接在浏览器中打开，看到API接口文档已经生成。runapi还有全局参数、环境隔离。其实Postman也支持这样的功能，不过毕竟不是国内产品，网络访问等方面很受限制。
还有一个比较好的地方，Runapi支持接口执行前后的脚本，比如响应数据的断言测试，弹框显示都挺好用的。
本文内容不用于商业目的，如涉及知识产权问题，请权利人联系51Testing小编(021-64471599-8017)，我们将立即处理
