接口文档

1.什么是接口文档

接口文档，顾名思义就是接口的说明文档，它是我们调用接口的依据。好的接口文档包含了对接口URL，参数以及输出内容的说明，我们参照接口文档就能方便的知道接口的作用，以及接口如何进行调用。

2.接口文档的组成部分

接口文档可以包含很多信息，也可以按需进行精简，不过，一个合格的接口文档，应该包含以下6项内容，从而为接口的调用提供依据:
　1.接口名称：用来标识各个接口的简单说明，如登录接口，获取图书列表接口等

　2.接口URl：接口的调用地址

　3.调用方式：接口的调用方式，如GET或POST

　4.参数格式：接口需要传递的参数 ，每个参数必须包含参数名称，参数类型，是否必选，参数说明这4项内容

　5.响应格式：接口的返回值的详细描述、一般包含数据名称、数据类型、说明3项内容

　6.返回示例(可选)：通过对象的形式，例举服务器返回数据的结构

3.接口文档示例：