一、为什么要写接口文档?
1.正规的团队合作或者是项目对接,接口文档是非常重要的,一般接口文档都是通过开发人员写的。一个工整的文档显得是非重要。
2.项目开发过程中前后端工程师有一个统一的文件进行沟通交流开发,项目维护中或者项目人员更迭,方便后期人员查看、维护
二、接口文档的格式
接口主要分为四部分:方法、uri、请求参数、返回参数

三、接口文档生成工具
apipost 一款很不错的接口测试工具,它可以生成各种格式的接口文档,有在线版的,markdown 格式和 word 格式的接口文档。
点击分享当前接口

分享

复制链接在浏览器中打开

下载其他格式的接口文档

word 格式的接口文档(word 只支持 json 格式的排版,所以百度放回的数据格式在 word 中显示不规范)

单个接口的 word 格式的接口文档可以免费下载,下载多个简单文档和一个项目的接口文档的时间就需要开会员了。
还有就是 apipost 下载多个 word 格式的接口文档的时候,每个接口是单独的接口文档需要合并。wps 和 office 里面都有合并功能。
在插入中的对象中找到文件中的文字然后点击选择所有接口就可以合并了。


![](/uploads/photo/2020/5a4b9bbb-5691-40f3-924e-86c67cbebc55.png! large
这就是接口文档生成工具
apipost 下载地址:https://www.apipost.cn/?dt=20201028


↙↙↙阅读原文可查看相关链接,并与作者交流