前言

掌握了 http 协议，就掌握了接口测试

笔者在网络上看过不少接口测试教程，一上来就开始讲怎么操作工具，而不告诉读者为什么要这么操作。读者可能照猫画虎成功了，也可能操作失败了但不知为何出错。

因此，本文作为接口测试的入门第一课首先会给大家了解到执行接口测试每一步操作的目的和原理，由此大家才能从理论到实践上掌握接口测试，并且熟练之后有自己的创造性发挥。

本文所用的接口测试工具为 Apifox，请大家在往下读之前先安装注册好工具。

Apifox 官方下载地址：http://www.apifox.cn

目录

1. 接口测试测什么
2. 接口测试的对象：服务器接口
3. 服务器接口与前端通信的方式：http 协议
4. Apifox 接口测试原理
5. 用 Apifox 构建第一个接口请求

正文

一.接口测试测什么

接口测试主要是测试系统
组件间接口的一种测试，主要用于测试服务器与前端（web 浏览器，APP）之间的数据交互接口。
测试的重点是要检查接口参数传递的正确性，接口功能实现的正确性，输出结果的正确性，以及对各种异常情况的容错处理的完整性和合理性。

由引文对接口测试的定义可得，接口测试的对象是服务器接口，接口测试的内容包括：接口参数检验，接口功能实现是否正确，接口异常情况容错处理。

接口测试的内容是《Apifox 接口测试》系列教程后面的内容，本文主要讲解服务器接口，前端如何通过 http 协议与服务器通信，Apifox 等接口测试工具如何实现接口测试。

二.接口测试的对象：服务器接口

API 指的是一组预先定义好的函数，来让系统或外部的其他组件可以执行它内部实现的功能，但又无须访问源代码或者理解其内部逻辑。

在需求开发过程中，前后端分离开发，两端的研发人员会共同定义好接口，编写接口文档，此后的开发过程中需要遵循这份协议文档。

因此接口测试也是一种黑盒测试，测试人员需要根据接口文档来对服务器 Api 进行测试，来检测约定的功能是否正确实现，是否有对异常情况做容错处理。

而接口文档的编写是依据前后端数据传输的协议——Http 协议进行的。

要会用接口文档，首先先理解 http 协议。

服务器接口与前端通信的方式：http 协议

服务器和前端通过互相发送 http 报文完成数据交互。本小节将介绍如何创建 http 报文，以及如何理解报文的每一个部分，了解完就可以掌握接口测试的基础内容。

• http 报文的三个组成部分
  http 报文是一个格式化数据块。报文类型包括客户端请求，服务器响应。它们由 3 个部分组成：

  • 起始行（start line） 对报文进行描述
  • 首部块（header） 包含属性 Content-Type： Content-Length：
  • 主体（body） 包含文本或二进制数据，可以为空

• 请求报文的格式

<method><request-URL><version>
<headers>
<entity-body>

• 响应报文的格式

<version><status><reason-phrase>
<headers>
<entity-body>

• 各个字段的含义如下：

方法（method）：前端希望对服务器执行的操作，包含 get，post，put，delete 等方法；

方法	功能
GET	从服务器获取数据
POST	向服务器发送要处理的数据
HEAD	只从服务器获取文档的首部
DELETE	从服务器上删除数据
PUT	向服务器提交数据

请求 url（request-URL）:所请求资源路径，通过它可找到资源放置的位置。
格式类似于：https://www.apifox.cn/help/app/contact-us/

版本 (version):报文所使用的 http 版本，格式类似于：HTTP/1.0

首部 (headers)：可以有 0 个或多个首部，常见的首部如下：

实体主体（entity-body）:包含一个数据块，支持多种数据格式，如 html 页面，图片，视频，源代码等等。

状态码 (status-code)：描述请求结果，成功或者失败。

原因短语 (reason-phrase):原因短语是状态码的可读版本，只对人类有意义。

这些字段初学者会觉得非常抽象难以理解和记忆，但当后面接触到 api 文档和用 apifox 做接口测试的时候，就会顿悟——api 文档里的参数和方法，url 的含义和接口测试界面每个空格要填什么，返回值代表什么含义。

请耐心继续往下读。

三.读懂 API 文档

对于测试人员，准备接口测试所需要的文档有产品需求文档 +API 文档。

需求文档用于梳理接口为何这么设计、是否合理；

针对单个接口，接口文档用于获取：接口描述，请求说明，返回说明。

以百度开放 API，文字识别接口为例：我们想要使用它的文本识别功能，需要去调用它的接口，那么需要了解发起这个文本识别接口请求，每个字段需要填什么内容。

* 注：Apifox 的 ApiHub 中，收集了大量开放的 API，初学者可选取某个 api 深入了解接口文档，或作为接口测试的练习物料，注意有些接口需要先获取使用权限。

四.Apifox 接口测试原理

对于服务器来说，Apifox 也是一个前端，只不过其他前端的接口请求由研发人员在代码里封装好，在特定条件下被触发发起请求，而 Apifox 中，接口请求由用户手动封装，手动发起。

看完 Apifox 接口测试的界面，读者想必能发现，整个界面就是让读者手动构建出一个 http 请求出来，上两节我们讲的抽象的 http 协议终于落了地。

因此一个最基础的 http 接口测试所需要做的步骤就是手动填写完成并发出一个 http 请求，校验参数。

step1.选择请求方法->填写请求 url->填写 url 参数->填写 body 参数和 header 参数（如果有）

step2.手动发送请求

step3.查看返回参数是否正常，是否符合接口文档的约定

五. 用 Apifox 构建你第一个测试请求

在铺垫完上述那么多理论基础之后，大家终于可以开始上手使用 apifox 来做接口测试了。

（一）练习 1：用 get 请求获取 html 页面

step1：在 apifox 的新建接口 tab 输入 “http://www.baidu.com,请求方法选择 GET，header 参数，url 参数，body 参数均为空，接着点击 send 按钮。”

step2：查看返回值，可以看到请求回来的数据是一个 html 页面，即百度首页，我们点击 ‘preview’ 按钮，可以看到一个完整的页面显示出来

（二）练习 2：获取百度开放 API 的 acess_token，即获得使用 api 的授权

step1：查看百度开放 api 获取 acess_token 的接口文档，获取请求方法和请求参数

step2：根据接口文档描述的，在 apifox 接口测试界面选择 post 方法，在 params 里填写 3 个请求参数，
（client_id 和 client_secret 需要创建应用后才能获得，没有可以先去创建）

step3：点击下方实际请求tab，可以看到 apifox 实际发出的接口请求形式
如下：

step4：查看返回参数可看到返回了我们需要的 acess_token 字段：

练习完成。大家可以利用自己公司内部的接口文档/外部开放 api 继续进行练习巩固。

复习题

1.写出 http 协议请求报文和相应报文的格式，并说明每个字段的含义。

2.api 文档有哪几部分组成，在接口测试中分别发挥什么作用

3.复述用 Apifox 做简单接口测试的步骤。