接口测试（一）—— 接口测试理论、接口测试工具、接口测试流程、接口用例设计

1. 按协议划分：http、tcp、IP

2. 按语言划分：C++、java、php

3. 按范围划分：

        系统之间：

                多个内部系统之间

                内部系统与外部系统之间

        程序之间：

                方法与方法之间，函数与函数之间，模块与模块之间

3、接口测试

对系统或组件之间的接口进行测试。校验传递的数据正确性和逻辑依赖关系的正确性

3.1、原理

接口测试，主要针对的测试目标 —— 服务器

怎么测？

模拟客户端，向服务器发送请求

用什么测？

工具：fiddler、postman、jmter

代码：python + UnitTest框架 + Requests框架

测什么？

测试服务器针对客户端请求，回发的响应数据是否与预期结果一致

人眼对比

断言

3.2、特点（价值）

符合质量控制前移的理念

可以发现一些页面操作发现不了的问题

接口测试低成本高效益

接口测试是从用户的角度对系统进行检测

3.3、实现方式

工具：

JMeter：使⽤难度较⼤，上⼿难度⼤；功能⻬全。

Postman：使⽤简单，上⼿难度低；功能较少。

fiddler

代码：

Python + Requests + UnitTest

java + HttpClient

3.4、什么是自动化接口测试？

借助工具、代码，模拟客户端发送请求给服务器，借助断言自动判断 预期结果和实际结果 是否一致

二、HTTP协议

协议：就是规则。要求通信的双方必须严格遵守

1、HTTP协议简介

HTTP：（HyperText Transfer Protocol）超文本传输协议，是一个基于请求与响应模式的、应用层的协议，也是互联网上应用最为广泛的一种网络协议。

特征：

支持客户端/服务器模式

简单快速

灵活

无连接

无状态

2、URL格式

概念：（Uniform Resource Locator）统一资源定位符。

作用：在网络环境中，唯一的定义一个数据资源。

开源商城

协议：http。规定数据传输的方式。

域名（IP）：在网络环境中找到主机。—— 用 :// 与协议隔分

端口（port）：（常省略）在网络主机上，标识一个进程（应用程序）—— 用: 与域名

资源路径：标识网络资源（文件、图片、音视频、变量...）—— 用: / 与端口格分

查询参数：传递给资源路径对应的数据。—— 用 ? 与资源路径隔分。查询参数内部用 & 隔分多个key-value对

3、HTTP请求

作用：

客户端(app、浏览器)，发送请求给服务器时，使用的协议 —— http请求协议。

规定发送给服务器的数据传输的语法格式。

3.1、整体格式

请求行：http请求第一行。请求方法 (空格) URL (空格) 协议版本

请求头：语法格式：k ：v

User-Agent：描述请求发送端的浏览器类型。

Content-Type：描述请求体的数据类型！

空行：代表http请求头结束。

请求体：请求发送时携带的数据。数据类型 Content-Type 的值！

post 和 put 有请求体

get 和 delete 没有请求体

3.2、fiddler 抓包验证

3.3、请求行

http 请求方法：大小写均可。

GET：查询。 —— 没有请求体

POST：添加。（登录时常用）

put: 修改。

delete: 删除。 —— 没有请求体

3.4、请求头

数据格式：k：v

Content-Type：

application/json： JSON数据格式

application/x-www-form-urlencoded： form表单数据

3.5、请求体

GET和DELETE 没有

PUT 和POST有

数据类型受 Content-Type 值影响。

4、HTTP响应

作用：

服务器端，针对客户端发送的 http请求，回发响应数据。—— http应答！

规定回发给客户端的数据组织格式。

4.1、整体格式

响应行（状态行）：协议版本 (空格) 状态码 (空格) 状态描述

响应头：语法格式：k:v

Content-Type: 描述响应体中数据类型。

空行：代表响应头结束

响应体：绝大多数不为空。（请求成功：回发数据，失败：回发错误信息）

数据类型受 Content-Type值影响。

4.2、状态行

状态码：

1xx：代表指示信息。表请求已经被接收，等待继续处理。

2xx：代表请求成功被处理、接收。常见：200、201

3xx：重定向，待访问的资源，需求重新指定路径访问。

4xx：代表客户端错误。常见：404、 403

5xx：访问器端错误。

状态码描述：一般与状态码唯一对应。 200 —— ok； 404 —— file not found

4.3、响应头

语法格式：k：v

Content-Type：值为响应体的数据类型。

Content-Length: 响应体的大小。可以不写，浏览器会自动求取。一旦写，必须准确！

4.4、响应体

回发给客户端的消息内容。常见的有 html网页、xml、json

三、接口规范

1、传统风格接口

特点：

请求方法，只使用 get 和 post 即可。

URL 不唯一。同一个操作可以对应不同的 URL

状态码的使用较单一。200 最常见。

2、RESTful风格接口

特点：

每一个URL代表一种资源；

客户端和服务器之间，传递这种资源的某种表现层；
表现层：数据的不同表现形式（如：图片、文字表现同一个数据对象）

客户端通过四个HTTP动词（GET、post、delete、put），对服务器端资源进行操作，实现"表现层状态转化"；

接口之间传递的数据最常用格式为JSON。

四、接口测试流程

分析需求，产生需求文档（产品）。

（开发产生接口文档）解析接口文档。

产生接口测试用例（送审）。

执行测试用例

工具：postman、jmeter、fidller

代码：python + Requests +UnitTest

提交、跟踪缺陷。

生成测试报告。

（可选）接口自动化持续集成！

五、接口文档

1、什么是接口文档

由开发人员编写，描述接口信息的文档。开发团队按接口文档进行开发工作，并要一直维护遵守。

2、作用

能够让前端开发与后台开发人员更好的配合，提高工作效率。（有一个统一参考的文件）

项目迭代或者项目人员更迭时，方便后期人员查看和维护

方便测试人员进行接口测试

3、展现形式

word 文档形式

Excel 表格式形式

pdf 文档形式。

4、结构

基本信息：

资源路径（协议和域名在 “系统信息”中）

请求方法

接口描述

请求参数：

请求头：

Content-Type。描述请求体的数据类型！

请求体：

实现该接口使用的数据及对应类型。

返回数据：

状态码 200

错误码（自定义状态码）

码值

描述信息。

5、接口文档解析

接口文档的解析本质：从接口文档中，找出 http 请求所需要的数据信息。

主要包含：请求方法、URL 、请求头、请求体、响应状态码、描述。

以 “登录” 为例：

请求方法：POST

URL：http://ihrm-test.itheima.net/api/sys/login

请求头：Content-Type ：application/json

请求体：{“mobile”:”13800000002”, “password”:”123456”}

响应状态码：200

错误码：

10000：操作成功！

20001：用户名或密码错误

99999：抱歉，系统繁忙，请稍后重试！

五、接口用例设计

分析接口文档，设计编写接口测试用例

为什么写？

防止测试点漏测。条理清晰

方便分配工作，评估工作量和时间

面试时使用！

1、接口测试的测试点

测试点称之为测试维度

1.1、功能测试

单接口功能：

手工测试中的单个业务模块，一般对应一个接口。

登录业务 ——> 登录接口

加入购物车业务 ——> 加入购物车接口

订单业务 ——> 订单接口

支付业务 ——> 支付接口

借助工具、代码。绕开前端界面，组织接口所需要的数据，展开接口测试。

业务场景功能：

按照用户实际使用场景，梳理接口业务场景。

组织业务场景时，一般只需做正向测试即可（与手工一致）。

一般建议用最少的用例覆盖最多的业务场景。

登录 —— 搜索商品 —— 加购物车 —— 下单 —— 支付 —— 评价

1.2、性能测试

响应时长

吞吐量

并发数量

服务器资源利用率

1.3、安全测试

攻击安全。 —— 与测试工程师无关。

业务安全。 —— 测试的方向。

敏感数据是否加密

SQL注入：在用户能输入数据的位置，写入SQL语句。

SQL注入安全，用户恶意写入的SQL语句，不会执行，查询数据库！

2、设计方法与思路

2.1、与手工设计相同之处

手工测试对应的功能测试点，与接口测试对应的功能完全一致。

tpshop商城登录页面，手工功能测试用例设计要点：

页面布局是否符合需求

测试用户名输入框，输入的数据是否正确。

测试密码输入框，输入的数据是否正确。

测试验证码输入框，输入的数据是否正确。

tpshop商城登录页面，接口测试用例设计要点：

测试用户名输入框对应的 username 的值是否正确。
测试密码输入框对应的 password 的值，是否正确。
测试验证码输入框对应的 verify_code 的值，是否正确。

2.2、与手工设计不同之处

手工测试，测写入到输入框中的数据是否正确。接口测试测参数对应的参数值是否正确。

接口测试，不单单针对参数值进行，还可以针对 参数本身 进行测试。

正向参数：

必选参数：所有的必选（必填）都包含。

组合参数：所有的必选 + 任意一个或多个可选参数。

全部参数：所有的必选 + 所有的可选参数

反向参数：

多参：多出一个或多个必选参数（可以任意指定）

少参：缺少一个或多个必选参数。

无参：没有必选参数。

错误参数：参数名输入错误。

3、单接口测试用例

手工测试用例文档 8 大要素：

编号、用例名称（标题）、模块、优先级、预置条件、测试数据、操作步骤、预期结果

接口测用例文档 10 要素：

编号、用例名称（标题）、模块、优先级、预置条件、请求方法、URL、请求头、请求体(请求数据)、预期结果

分析接口文档，以 “登录接口” 为例：

请求方法：post

URL： “系统信息” 中的协议和域名 + /api/sys/login

请求头：Content-Type : application/json

请求体：{"mobile":"13800000002","password":"123456"}

预期结果： {"success":true,"code":10000,"message":"操作成功！","data":"f5050a1b-7919-444c-9ec4-3c1a7286536d"}

data：值为登录成功生成的令牌数据。该数据会定时变化。

登录模块的接口测试用例测试点：

数值

正向：

登录成功

反向：

用户名为空

用户名包含特殊字符、字母

用户名超过11位（12位）

用户名不足11位（10位）

用户名未注册

密码为空

密码包含特殊字符、字母

密码为1位

密码为100位

密码错误

参数（接口测试特有）

正向：

必选参数：正确用户名 + 正确密码

组合参数：忽略

全部参数：正确用户名 + 正确密码

反向：

多参：多 abc：“123”

少参（少mobile）：没有用户名，正确密码

无参：没有任何参数

错误参数(手机号参数名错误)：abc:1381234567, password:”123456”

正向 1 条、用户名相关 5 条、密码相关 5 条、参数相关 5 条

测试用例参考文档：百度下载链接 CSDN下载链接