10.4. API 文档
API 文档
完成了所有的 API 及测试,我们需要有个一份接口文档,方便他人使用,这一节我们来介绍一下快速生成 API 文档的方法。
PostMan
PostMan 导出的 Collection 其实已经是一份基础的接口文档,可以进一步补充请求参数的描述信息。
当然也有很多缺点:
- 需要通过导入导出来分享文档;
- 没法对响应结果进行详细说明;
- 没有地方添加关于当个接口的进一步说明;
当然了付费用户可以享受更多方便的功能,我们在这里不做进一步讨论。
Apizza 介绍
Apizza 是一款在线的 API 协作管理工具,界面及使用方式与 PostMan 基本类似,可以理解为一款在线版的 PostMan。
但是与 PostMan 相比,功能要更加的丰富,比如我们可以更加详细的定义请求参数和参数类型。
可以更加详细的描述响...