做为后端开发者，如何更优雅、便捷的生成接口文档？

对于一个后端人员，给可爱的前端妹子或者帅气的app开发小哥哥生成接口文档是一件必不可少而又十分头疼的事情。一般状况下，咱们会用postman调试接口，而后用rap、甚至word等工具再编写接口文档，重复工做，十分难受。

apipost的出现，解决了全部后端开发人员的痛点。

apipost的定位是：一款提高开发、测试团队效率，可直接生成文档的API调试、管理工具。

它的便捷之处，便在于它不只完美支持相似postman的接口调试功能，并且更重要的是，它支持快速、优雅的生成漂亮的文档。

如下界面，就是apipost接口调试控制台的全貌。

是否是很熟悉？事实上，除了相似postman那些您熟悉的配方和味道的接口调试功能，它也加入了更多适合中国人习惯的小功能。好比：

亮点小功能之：快速导入参数

apipost支持多种格式的参数导入，见下图，你不再用一个一个参数的慢慢写了：

导入格式支持key-value和json格式：

1-1：key-value格式导入示例：

key-value格式常见的就是浏览器（F12）控制台的数据格式，见下图：

咱们，复制以上请求头参数，而后粘贴到apipost，点击导入

参数则瞬间导入到了请求参数中，见下图：

以上示例只是展现了如何快速导入到header参数，其余参数好比query、body操做方式是如出一辙滴。

1-2：json格式导入示例：

apipost也支持json格式的参数导入，参数格式能够以下：

{
	"id": 123, "title": "我是标题" }

如图，点击导入，参数也快速导入到了请求参数中。

亮点小功能之：参数注释自动识别

上面咱们写了如何快速导入参数，其实对于生成接口文档来讲，参数描述（注释）才是最要命的，对于咱们一直忙碌的程序员，花大量时间用在写文档上实在太累！

好在apipost帮咱们节省了不少时间，一个参数，只要写过一次注释，下次遇到一样的参数直接选中就行。举例：

在上图中，咱们针对id和title写了对应的注释：

id：“我是文章Id”

title：“我是文章标题”

当咱们新建一个接口的时候，假如这个接口一样用到了 id或者title等参数，点击参数描述就会呈现出刚刚输入过的参数描述，直接选中便可，不用再麻烦的打字输入了。

这个小功能是否是节约了开发小伙伴不少时间呢？

亮点小功能之：快速定位当前接口目录

左侧的目录默认都是闭合的，有时候咱们不知道当前正在编辑的接口属于哪一个目录，找起来至关头疼。apipost提供了“定位到当前接口目录” 功能（见下图），能够快速打开当前正在编辑的接口、文档所在的目录，是否是解决了您的大问题了呢？

其实，apipost还有不少不少更加符合中国人操做习惯的小功能，等待您去发现。

说了这么多，好像还没说到重点，apipost怎么生成接口文档呢？很简单：新版ApiPost支持分享单个项目、也支持分享单个目录或者文档：

支持设置文档连接的有效期：

支持设置文档的查看权限：

小TIPS：apipost 导出文档响应为空？

不少小伙伴问，为何apipost 导出文档响应为空？那是由于你么有添加响应示例。

ApiPost生成的文档怎么添加响应示例？很简单：