利用ApiPost一键、快速生成接口文档！女猿也过38节！

对于我们这些程序员和程序媛来讲，最头疼的莫过于写文档。

我们可都是正个八经的理工校草和理工女神，研究github、逛逛csdn、写hello world是才我们的拿手菜，写文档是文科生的事情好不啦？（手动吐哇吐）

今天，教大家一个妙招：利用ApiPost一键、快速生成接口文档！

妈妈再也不用担心自己女孩纸们没有时间过38节啦！

当女程序媛遇到问题，那就不是问题

ApiPost简介：

ApiPost是一个支持团队协作，并可直接生成文档的API调试、管理工具。它支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员不可多得的工具 。

官网：https://www.apipost.cn/

如果你对ApiPost了解不多，可以戳这里：https://cloud.tencent.com/developer/article/1399828

利用ApiPost一键、快速生成接口文档：

当然，你得先下载安装apipost谷歌拓展或者客户端（个人建议客户端）。

接下来介绍具体步骤。

1、我们先准备一段接口代码用来测试。如图：

d75b5f5aa212c079b1d3fd55ceb95ce21aa627a6

这个代码仅仅用来demo没啥技术含量，就是接受POST过来的2个参数，然后返回一个json。

2、接下来，具体操作如下图（全程图片-一看就懂）：

5326b1c76768e0941bfebcf66574593dc28bfb65

57debf0669faa661a231088844e197ce85a490be

3、利用全局注释功能，快速创建常见字段的描述

27fe85112b793c6028fca0178f573c785f7fd781

06f7809994ca7c38a67bd3838eae68f8aabcf4f5

5fa632ba1ac8bea4f9ddc38cba4f3910d018fe3b

4、点击顶部的文档模式就可以查看文档了。也可以导出为离线文档。

2722c36f10ac0c5bfbe83f5a26f90fa46685ffd8

2da78d14c0729c908b42d12d434658ef6cee1d28

嗯，好了。女神们，接口文档也生成了，赶紧丢给前端过节去吧！……(^ _ ^)