PostMan接口测试(很全面的接口测试教程)-测试

捐助

PostMan接口测试(很全面的接口测试教程)

作者昵称：千里和他的软件测试

次浏览

2021-1-12

编辑推荐:

本文主要讲解了Postman基础原理、工具应用等相关内容。
本文来自于博客园，由火龙果软件Anna编辑、推荐。

一：理论部分

1. 前言

在前后端分离开发时，后端工作人员完成系统接口开发后，需要与前端人员对接，测试调试接口，验证接口的正确性可用性。而这要求前端开发进度和后端进度保持基本一致，任何一方的进度跟不上，都无法及时完成功能模块的测试。

做为后端开发人员，要求独立开发完成某个接口后，开发人员自己需要先测试通过后再提交给测试人员进行测试，否则会出现到测试人员哪里业务流程根本就走不通，或者BUG会过多的情况等。

市场上有很多优秀的，完善的接口测试工具，比如SoapUI，Postman，JMeter、yapi等，能够高效的帮助后端开发人员独立进行接口测试。这里使用Postman接口测试工具，分别介绍如何对GET请求和POST请求进行接口测试。

2. Postman简介

Postman是一个接口测试工具，在做接口测试的时候，Postman相当于一个客户端，它可以模拟用户发起的各类HTTP请求，将请求数据发送至服务端，获取对应的响应结果，

从而验证响应中的结果数据是否和预期值相匹配；并确保开发人员能够及时处理接口中的bug，进而保证产品上线之后的稳定性和安全性。

它主要是用来模拟各种HTTP请求的(如:get/post/delete/put..等等),Postman与浏览器的区别在于有的浏览器不能输出Json格式，而Postman更直观接口返回的结果。

3.Postman界面图

各个功能区的使用如下：

l 快捷区：快捷区提供常用的操作入口，包括运行收藏夹的一组测试数据，导入别人共享的收藏夹测试数据（Import from file, Import from folder, Import from link等），或新建请求、收藏夹、环境变量等。

l 侧边栏：包括搜索栏， Request 请求的历史记录和收藏夹管理。

l 功能区： Request 请求设置，查看 Response 响应结果和测试结果，可以将请求保存到收藏夹。

l 设置区：设置和管理环境变量和全局变量。

二：工具应用

1. 新建接口

1.1 创建Collection集合

在刚开始一个项目时，为了后续便于组织和管理，把同属该项目的多个 API，放在一组里。所以要先去新建一个 Collection: New -> Collection

1.2 创建请求

1.3 设置HTTP请求

设置 HTTP 的 Method 方法和输入 api 的地址以及请求参数或请求体

以下为获取微信公众号为案例所设计的HTTP请求

GET是请求方法，请求方法是HTTP请求的必要要素，常见的请求方法有GET和POST两种。API地址一般为URL地址。如果是请求URL中的入参，会在Params列出参数名称及参数取值，方便我们轻松的修改各入参的值。如有需要，还应该设置HTTP请求Headers部分。

如果是POST请求，需要将请求方法设置为POST，一般说来POST请求是有请求体的，固需要在Body部分中编写正确的请求body内容和Content-Type的值（在Headers中进行设置）

1.3.1 GET和POST的区别

l GET 使用URL 或Cookie 传参，而POST将数据放在Body 中。

l GET的URL 在长度上会有限制，而POST没有。

l POST比GET相对安全，因为在地址栏不可见。

l 一般POST请求用来获取数据，POST请求用来发送数据。

对于上面的区别，其实第一点POST也可以将数据放在URL里，GET请求其实也没有长度限制，POST请求看起来是隐式的，但是可以通过抓包拿到参数。

1.4 发送HTTP请求

点击上图中蓝色Send图标即可发送请求，验证请求结果是否正确。下图是对应的响应结果，包含Body和Headers两个部分，Body即响应体正文，Headers即为响应头信息，响应头不包含响应状态码和状态信息部分。

响应体包含三种查看模式，分别为：Pretty默认模式、Raw原始数据格式，Preview预览模式（此模式针对HTML页面效果很好）。

1.5 关联技术

关键技术是将前一个请求的响应结果保存到变量中，再将此变量在后续请求中进行引用。

1.5.1 保存前一个请求的响应数据

因为Tests模块是后置模式，可对响应进行处理。我们可以通过赋值方式把响应结果保存到变量中，参考代码如下：

1.5.2 对后一个请求进行参数化

因前面将access_token的值保存到了环境变量中，所以在该请求中，只需要进行参数引用即可。

1.5.3 关联的高级操作

利用Send a request实现前置步骤，例如：客服发消息模块，前置步骤是获取access_token，我们可在Pre-request Script前置步骤中发送请求，将该请求的结果保存到环境变量accesstoken中，然后在主请求中引用该环境变量即可。

1.5.4 附：前置步骤中发送POST请求

POST请求相比GET请求要复杂一点，因为其需要加入请求Header和请求Body，以下是Pre-request Script在发送POST请求的案例：

构造一个登录请求

const loginRequest = {
url: 'http://115.28.108.130: 5000/api/user/login/',
method: "POST",
body: {
mode: 'urlencoded', // 模式为表单url编码模式
urlencoded: 'name=张三 &password=123456'
}
};

发送请求

pm.sendRequest (loginRequest, function (err, res) {
console.log(err ? err : res.text());
});

发送JSON格式请求与发送POST请求类似，以下采用了raw模式发送请求体。

构造一个注册请求

const regRequest = {
url: 'http://115.28.108.130: 5000/api/user/reg/',
method: 'POST',
header: 'Content-Type: application/json', //注意要在Header中声明内容使用的类型
body: {
mode: 'raw', // 使用raw(原始)格式
raw: JSON.stringify ({ name: '小小', password: '123456' }) //要将JSON对象转为文本发送
}
};

发送请求

pm.sendRequest (regRequest, function (err, res) {
console.log (err ? err : res.json()); // 响应为JSON格式可以使用res.json()获取到JSON对象
});

因为HTTP请求都支持raw格式，我们只要能够获取请求的raw格式，便可采用raw模式发送任意类型的请求体了。

2.接口数据用例

2.1 数据用例设计

Postman支持的是csv文件作为数据用例，数据用例包含三大部分，分别为：用例标题（title），入参（grant_type，appid，secret），期望结果（expected）

我们可以根据黑盒用例设计方法如等价类、边界值、判定表、正交实验法对入参进行用例设计，得到各种不同的测试场景（取值组合）

2.2 数据用例参数化

前面我们在csv文件中编写好了数据用例，且保证第一行为参数的名称。将请求中入参值依次进行替换，在Postman中参数的编写规格为两个花括号，如：{{appid}}

2.3 设置迭代器

要读取所有的测试用例，需要设置迭代器让其循环读取那些测试数据。Postman中设置迭代器需在Run中完成，请看【4.Runner执行测试】

3.结果检查（断言）

Postman的断言功能在Test模块中，比如要测试返回结果是否含有某一字符串，就需要在Test中编写相应的代码，Test中的代码使用的是JavaScript语法。

3.1 Postman自带Tests函数

Postman提供了参考代码供我们选择即可，主要断言代码有如下几种：

# 断言状态码是否为200，在断言中此种断言价值不高

pm.test ("Status code is 200", function () {
pm.response.to.have.status(200);
});

# 断言响应文本中是否包含某个数据串，常用

pm.test ("Body matches string", function () {
pm.expect (pm.response.text()).to.include ("string_you_want_to_search");
});

# 使用JsonPath断言

pm.test("Your test name", function () {
var jsonData = pm.response.json();
pm.expect(jsonData.value).to.eql(100);
});

# 检查响应正文中是否包含某个子串

pm.test("Body is correct", function () {
pm.response.to.have.body("response_body_string");
});

# 响应信息包含列表中其中某一个

pm.test("Successful POST request", function () {
pm.expect(pm.response.code).to.be.oneOf([201,202]);
});

# 将xml响应转为json

var jsonObject = xml2Json(responseBody);

3.2 手工tests函数

也可以使用断言并赋值的形式，相对而言，以下方式会更为简洁实用。

常见的断言代码有：

# 检查response的body中是否包含字符串

tests["Body matches string"] = responseBody.has("string_you_want_to_search");

# 检查JSON节点的值和节点元素的个数为5

var data = JSON.parse(responseBody).city; //把JSON字符串转化为对象
tests["Your test name"] = data.value===100;
tests["program's lenght"] = data.programs.length===5;

# 验证Response time是否小于某个值

tests["Response time is less than 200ms"] = responseTime < 200;

3.3 tests高级操作

我们可以引用数据用例csv文档中的预期结果进行断言。

var jsonData = JSON.parse(responseBody) ;
# data.expected 为csv数据文件中的预期结
tests["测试结果通过"] = jsonData.expires_in===data.expected ;

在tests还可以使用判断语句进行断言，如下：

在Postman中断言的操作非常灵活，需要同学们多进行练习。

pm.test ("预期结果包含：长沙，实际结果为："+result, function () {
if (JSON.parse(responseBody).city==="长沙"){
pm.expect (pm.response.text()).to.include("千里");
pm.expect (pm.response.text()).to.include("长沙");
}else if (JSON.parse(responseBody).city==="Changsha"){
pm.expect (pm.response.text()).to.include("千里");
pm.expect (pm.response.text()).to.include("Changsha");
}else if (JSON.parse(responseBody).city==="長沙"){
pm.expect (pm.response.text()).to.include("千里");
pm.expect (pm.response.text()).to.include("長沙");
}
});

4.Runner执行测试

4.1 设置迭代器