公司：#小米 #快手 

岗位：#接口测试工程师 

关键字：#接口测试 #接口测试工程师 #API接口 首先，接口文档应该包含以下内容： 

1、接口说明 

2、调用url 

3、请求方法（get\post） 

4、请求参数、参数类型、请求参数说明 

5、返回参数说明 由接口文档可知，接口至少应有请求地址、请求方法、请求参数（入参和出参）组成，部分接口有请求头header。 

标头 (header)：是服务器以HTTP协议传HTML资料到浏览器前所送出的字串，在标头与 HTML 文件之间尚需空一行分隔，一般存放cookie、token等信息 

有同学问我header和入参有什么关系？它们不都是发送到服务器的参数吗？ 

首先，它们确实都是发送到服务器里的参数，但它们是有区别的，header里存放的参数一般存放的是一些校验信息，比如cookie，它是为了校验这个请求是否有权限请求服务器，如果有，它才能请求服务器，然后把请求地址连同入参一起发送到服务器，然后服务器会根据地址和入参来返回出参。

也就是说，服务器是先接受header信息进行判断该请求是否有权限请求，判断有权限后，才会接受请求地址和入参的。