下载:
postman官方地址
测试外部接口:测试被测系统和外部系统之间的接口。(只需要测试正例即可)
测试内部接口:
1.内部接口只提供给内部系统使用。(只需要测试正例即可)
2.内部接口提供给外部系统使用。(测试必须非常全面,正例,各种异常场景,权限控制)
一 接口测试的流程以及用例的设计
1.向开发要接口api文档(没有的话通过抓包工具获取):
熟悉接口业务,接口地址,入参,出参,鉴权码
2.编写接口用例以及评审
思路:
正例:输入正常入参,接口能够成功返回数据
反例:
- 鉴权反例:鉴权为空,鉴权码错误,鉴权码过期。。。
- 参数反例:参数为空,参数类型异常,参数长度异常。
- 错误码覆盖:根据业务而定的
- 其他错误场景:接口黑名单,接口使用次数限制,分页场景
项目名称 | 程序版本 | ||||||||
测试环境 | |||||||||
用例编号 | 测试接口 | 用例标题 | 请求方式 | 预置条件 | 操作步骤 | 输入数据 | 预期结果 | 优先级 | 数据库结果 |
二 postman安装,注册,登录
最好要注册,要不然会影响一些功能
步骤:
1.创建项目
api例子
三 发送get请求和响应页签详解
添加请求
右键--添加请求
请求url:
https://api.thecatapi.com/v1/votes
header
Content-Type:application/json
x-api-key:DEMO-API-KEY
请求页签
Params:get请求传参
Authorization:鉴权
headers:请求头
Body:post请求传参
- form-data:既可以传键值对参数也可以传文件
- x-www-form-urlencoded:只能够传键值对参数
- raw:可以传Text、JavaScript、JSON、HTML、XML
- binary:把文件以二进制的方式传参
Pre-request Script:请求之前的脚本
Tests:接口请求之后的脚本、断言
Coolies:用于管理cookies信息
响应页签:
Body:接口返回的数据
Pretty:以JSON XML HTML Text不同格式查看返回的数据
Row:以文本的方式查看返回的数据
Preview:以网页的方式查看返回的数据
Cookies:响应的Cookies信息
Headers:响应头
Test Results:断言的结果
200 状态码
OK 状态信息
441ms 响应的时间
743B 响应的字节数
四 发送post请求以及get和post的区别
请求地址:
https://api.thecatapi.com/v1/votes
HEADERS
Content-Type:application/json
x-api-key:DEMO-API-KEY
BODY raw
{"image_id":"39i","sub_id": "my-user-1234","value":4
}
面试题:
get请求和post请求的区别:
1.get请求一般是获取数据,post请求一般是提交数据。
2.post请求比get请求安全。
3.本质区别是传参的方式不一样:
- get请求在地址栏后面以?的方式传参,多个参数之间用&分隔。
- post请求是在body以表单的方式传参。
以上的问题:
多种环境:开发环境,测试环境,生产环境(两个接口的域名是一样的)
接口关联:需要手动关联(第一个接口返回的token值手动填到第二个接口的参数)
参数需要手动修改(name参数不能与已存在的标签名重复,每次修改需手动修改)
五 Postman的环境变量以及全局变量
开发环境,测试环境(变量名保持一致,都为ip)
用双大括号加变量名的方式来取得环境变量的值
send前,选择哪个环境
环境变量:环境变量就是全局变量
全局变量:全局变量是能够在任何接口里面访问的变量
获取环境变量和全局变量的方法:{{变量名}}
六 接口关联
1.Json提取器
使用json提取器实现接口关联(只能针对Josn数据)
第一个接口:
console.log(responseBody); //打印
//使用json提取器提取id值
//把返回的字符串格式的数据转换成对象的形式。
var result = JSON.parse(responseBody);
//把id设置为全局变量
//pm.globals.set("id", "result.id");pm.globals.set("id", "result[1].id");
第二个接口
{{id}}
2.正则表达式
我用的接口没有 token,可以看下面的部分(十四 Postman的Cookie鉴权和Token鉴权)
使用正则表达式的方式实现接口关联
正则表达式
- 开始标志位双引号"+正则表达式提取内容+结束标志位双引号"
- 需要传递获取的值用(.*?)代替
- 如果提取的内容含有双引号,那么标注位的双引号变为单引号
第一个接口
console.log(responseBody); //打印
//判断当返回结果中包含有id时才通过正则表达式去取值
if (responseBody.search("image_id")!=-1){//使用正则表达式提取器实现接口关联,match匹配。var result1 = responseBody.match(new RegExp('"image_id":"(.*?)"'));console.log(result1); //控制端输出结果var result2 = responseBody.match(new RegExp('"image_id":"(.*?)i'));console.log(result2); //控制端输出结果var result3 = responseBody.match(new RegExp('"image_id":"(.*?)9i'));console.log(result3); //控制端输出结果//设置为全局变量pm.globals.set("mage_id",result1[1]);}
//业务断言
pm.test("检查响应中包含的值", function () {pm.expect(pm.response.text()).to.include(31102);
});
第二个接口:
{{mage_id}}
七 Postman内置动态参数以及自定义的动态参数
postman内置动态参数:
{{$timestamp}} //生成当前时间的时间戳
{{$randomint}} //生成0-1000之间的随机数
{{$guid}} //生成速记GUID字符串
1.自定义时间戳参数
调用变量用{{times}}
//自定义动态参数时间戳
var times = Date.now();
console.log(times)
//设置为全局变量
pm.globals.set("times", times);
2.随机整数
//随机数
const randomInt = (min, max) => Math.floor(Math.random() * (max - min + 1)) +min;
//打印
console.log(randomMobile(100000000,999999999));
3.随机手机号
//随机数
const randomInt = (min, max) => Math.floor(Math.random() * (max - min + 1)) +min;
//随机手机号
var randomMobile = `18${randomInt(100000000,999999999)}`;
//打印
console.log(randomMobile);
4.等待时间
有些接口有调用时 2限制,5秒之内只能调用1次。
const sleep = (milliseconds) => {const start = Date.now();while (Date.now() <= start + milliseconds) {}};//等待2秒sleep(2000)
八 其他接口
1. 上传文件的接口
2. 删除信息接口
3. 更新数据接口
也就是一个增删改查的闭环
九、断言
常规的六种断言:
Status code:Code is 200 检查返回的状态码是否为200
Resoonse body:Contains String 检查响应中包含指定字符串
Response body:JSON value check 检查响应中其中json的值
Response body:Is equal to a string 检查响应等于一个字符串
Response headers:Content-Type header check 检查是否包含响应头Content-Type
Response time is less than 200ms 检查请求耗时小于200ms
点击右侧可以直接插入断言
1. 局部断言
//断言
//状态断言
pm.test("检查返回状态码为200", function () {pm.response.to.have.status(200);
});
//业务断言
pm.test("检查响应中包括id", function () {pm.expect(pm.response.text()).to.include("id");
});
//检查响应头中包含有Content-Type响应头
pm.test("Content-Type is present", function () {pm.response.to.have.header("Content-Type");
});
//检查响应时间少于500ms
pm.test("Response time is less than 200ms", function () {pm.expect(pm.response.responseTime).to.be.below(500);
});
//业务断言
pm.test("检查响应中id值", function () {var jsonData = pm.response.json();pm.expect(jsonData.id).to.eql(31102);
});
2. 全局断言
可以把状态断言放到全局断言里
十 postman批量运行测试用例
点击run后,进行设置
run运行
运行结果:
注意:
在批量运行测试用例时,如果接口中含有需要上传文件的接口,那么需要把文件存放在工作目录下,且允许访问外部工作目录
十一 postman数据驱动之CSV文件和JSON文件的处理
用第一个接口来做数据驱动,也就是说既有正例,又有反例
1. CSV
Postman(接口自动化测试)-CSDN博客
在任意位置新建一个CSV文件
1.1 修改参数
当数据文件写好之后,第一个要改的地方,参数取数据文件里面的值也是用双大括号来取
1.2 修改断言数据
第二个要改的地方,断言的时候写死的,要改成从数据文件里面取:
或者用apidata01["assert_value"]
console.log(responseBody); //打印
//使用json提取器提取id值
//把返回的字符串格式的数据转换成对象的形式。
var result = JSON.parse(responseBody);
//把id设置为全局变量
//pm.globals.set("id", "result.id");pm.globals.set("id", "result[1].id");//断言
//状态断言
pm.test("检查返回状态码为200", function () {pm.response.to.have.status(200);
});
//业务断言
pm.test("检查响应中包括id", function () {//pm.expect(pm.response.text()).to.include("id"); 修改前pm.expect(pm.response.text()).to.include(apidata01.assert_value); //修改后
});
//检查响应头中包含有Content-Type响应头
pm.test("Content-Type is present", function () {pm.response.to.have.header("Content-Type");
});
//检查响应时间少于500ms
pm.test("Response time is less than 200ms", function () {pm.expect(pm.response.responseTime).to.be.below(500);
});
1.3 修改正则表达式
判断当返回结果中包含有id时才通过正则表达式去取值
//判断当返回结果中包含有id时才通过正则表达式去取值
if (responseBody.search("id")!=-1){//使用正则表达式提取器实现接口关联,match匹配。var result = responseBody.match(new RegExp('"id":"(.*?)"'));console.log(result[1]); //控制端输出结果//设置为全局变量pm.globals.set("id",result[1]);}
//业务断言
pm.test("检查响应中包括id", function () {//pm.expect(pm.response.text()).to.include("id"); 修改前pm.expect(pm.response.text()).to.include(apidata01.vote_id); //修改后
});
1.4 导入csv文件
哪个接口有用到csv文件,哪个接口就☑️
然后运行
2. JSON
新建一个文件data.json
(mac:终端cd进入要创建文件的路径下,使用touch apidata.json指令即可)
[{"vote_id":"31102","assert_value":"31102"},{"vote_id":"31104","assert_value":"31104"}
]
其他操作都一样
十二 测试必须带请求头的接口
常见的请求头:
Host 请求的主机地址
Connection 连接方式
Accept 客户端接收到的数据格式
X-Requested-With 异步请求
User-Agent 客服端的用户类型
Referer 来源
Cookie Cookie信息
Content-Type 请求内容的格式
测试接口
https://www.baidu.com/s?wd=接口测试
如果没有加请求头的话,会发现响应显示有问题(至于哪个请求头是必填的,一般需要自己一个个的试)
十三 Postman接口Mock Server服务器
mock模拟
后端的接口还没有开发完成,前端的业务需要调用后端的接口。
下图中 2 部分的请求方式(GET)和URL中的 (test)都可以根据实际的需要进行修改
1. 自动生成一个环境变量:
2. 自动生成一个项目和请求
假设前端想要返回的数据如下(前端需要什么数据就填写什么数据)
{“error_code”:0,“msg”:“返回成功”,data:[]}
那就在default里面直接替代掉success,保存再去发送请求的时候就得到了想要的数据
再次发送效果:
在浏览器里访问测试下:
十四 Postman的Cookie鉴权和Token鉴权
什么是cookie?
cookie是一小段文本,格式key=value。
cookie鉴权的原理:
1.当客户端第一次访问服务器的时候,那么服务器就会生成Cookie信息,并且在响应头的set-cookie里面把生成的cookie信息发送给客户端。
2.当客户端第N次(N>1)访问服务器的时候,那么客户端就会在请求头的cookie带上cookie信息,从而实现鉴权。
cookie的分类:
会话cookie:保存在内存,当浏览器关闭之后就会自动化清除cookie。
持久cookie:保存在硬盘,浏览器关闭后不会清除,只有当失效时间到了才会自动清除。
F5刷新页面,浏览器按F12, Application->Cookies查看cookie:
接口一:访问接口
1.访问phpwind论坛首页接口
http://47.107.116.139/phpwind/
查看cookies
2.正则表达式提取token值
input type="hidden" name="csrf_token" value="13311087a61defe0"
正则表达式提取token值,在第二个接口请求参数里面用,实现token关联鉴权。
var result = responseBody.match(new RegExp('name="csrf_token" value="(.*?)"'));console.log(result);
//将 csrf_token设置为全局变量
pm.globals.set("csrf_token", result[1]);
接口二:登录接口
http://47.107.116.139/phpwind/index.php?m=u&c=login&a=dorun
接口一发送成功后,自动生成3个cookie,接口二带上这3个cookie请求才会成功(接口二的 3 个 cookie默认自动加上)
登录的抓包Header信息:
参数设置:
抓包的 Body部分
结果有success就是成功的!
十五 postman实现接口的加密和解密
1.目前市面上的加密方式
对称式加密:DES,AES,Base64加密算法
非对称加密:双钥(公钥,私钥,公钥加密私钥解密,私钥加密公钥解密)加密,RSA加密算法
不考虑加密:MD5,SHA1,SHA3
在线JSON校验格式化工具(Be JSON)
1.1 对称式:DES,AES加密解密
加密
解密
AES和上面的一样
1.2 对称式:Base64加密解密
1.3 非对称:双钥(公钥,私钥)加密,RSA加密算法
对admin进行公钥加密
用私钥进行解密
1.4 MD5加密解密
一般MD5加密,使用的是 “32 位大写 ”
解密
2. postman如何使用加密解密
市面上所有的加密中,MD5的加密使用是最广泛的
接口说明:
自定义的基于 flask的加密接口
postman中api设置:
对 username和password进行MD5加密 (在Pre-req中设置)
//poatman的MD5加密的方法
//打印 32 位小写
//var username = CryptoJS.MD5("admin").toString();
//打印 32 位大写
var username = CryptoJS.MD5("admin").toString().toUpperCase();
var password = CryptoJS.MD5("123").toString().toUpperCase();
console.log(username)
console.log(password)
//设置全局变量
pm.globals.get("username",username);
pm.globals.get("password",password);
然后,设置变量
实际运行接口会不成功,因为是本地接口,这个不重要,主要了解postman的MD5如何加密的即可!
十六 Postman+Newman+Jenkins实现接口测试持续集成
newman和newman-reporter-html下载安装
jenkins下载安装
1. newman
postman是专为接口测试而生,Newman是专为postman而生。newman可以让我们的postman的脚本通过非GUI(命令行)的方式。这样就可以和jenkins集成。
运行命令:newman run
常用参数:
-e 引用环境变量(开发环境/测试环境/生产环境)
-g 引用全局变量
-d 引用数据文件
-n 指定测试用例迭代的次数
-r cli,html,json,junit --reporter-html-export 指定生成HTML的报告
选择一个位置,新建一个名为postman的文件夹
然后
1.1 导出测试用例
导出名称改为test_case.json
1.2 导出生产环境
导出名称改为environment.json
1.3 导出全局变量
导出名称改为globals.json
1.4 数据文件也存放到postman文件夹中
总的导出文件如下:
1. 5 通过newman运行用例
进入 postman文件夹的路径下
运行
newman run test_case.json -e environment.json -g globals.json -d apidata01.csv -r cli,html,json,junit --reporter-html-export report.html
在 postman文件夹下,可以看到生成的html报告
用newman-reporter-htmlextra可以导出更漂亮的报告
newman run test_case.json -e environment.json -g globals.json -d apidata01.csv -r cli,htmlextra,json,junit --reporter-HTML-export report.html
或者不需要 json junit也可以
newman run test_case.json -e environment.json -g globals.json -d apidata01.csv -r htmlextra,cli
不知道是浏览器还是 Mac电脑的问题,我查看的报告也不是很漂亮。。。
2. jenkins插件安装
我用的版本是Jenkins 2.440.2 (jenkins页面右下角可查看)
2.1 安装HTML Publisher插件/Groovy插件/Startup Trigger插件
安装后可以在“Installed plugins”已安装列表查看
2.2 安装 newman
和 newman-reporter-html
2.2.1 安装 nodejs plugin
2.2.2 全局管理工具配置
安装 newman和newman-reporter-html
安装成功以后,Global npm packages to install部分的安装内容就可以不填了
查看是否安装成功:
创建Jenkins自由风格项目
- 构建步骤1:选择Execute NodeJS script
- 构建步骤2:选择执行shell脚本
步骤 1
步骤 2
构建结果
newman-reporter-html 安装及验证
——————————————————————————————————
3.创建 jenkins项目
3.1 进入 jenkins,新建项目
3.2 回到 jenkins首页,选择上一步创建的项目,进行配置Configure
配置上面导出的文件所在的空间(即 postman文件夹路径)
3.3 构建Execute NodeJS script
3.4 执行windows的批处理命令
构建 Execute windows batch command
macOS构建 Execute shell
newman run test_case.json -e environment.json -g globals.json -d apidata01.csv -r cli,html,json,junit --reporter-html-export report.html
masOS
cd /Users/mac/Documents/study23/postman
newman run test_case.json -e environment.json -g globals.json -d apidata01.csv -r cli,html,json,junit --reporter-html-export report.html
3.5 执行系统的Groovy脚本(目的:报告显示的样式可正常显示)
构建 Execute system Groovy script
System.setProperty("hudson.model.DirectoryBrowserSupport.CSP","")
mac
3.6 生成的HTML报告集成到jenkins
构建后操作 Publish HTML reports
3.7 项目运行
保存完成后,回到jenkins首页,posyman项目右键build now:
4. 生成报告
Jenkins内也能查看报告
5.报错信息
5.1 Groovry报错UnapprovedUsageException
点击批准即可
5.2 HTML Publisher报错java.nio.file.AccessDeniedException: /.file
报告的路径设置问题或权限问题
总结
Postman可以用来创建、发送、调试和记录HTTP请求,并且可以自动化测试流程和代码生成,并支持多种HTTP请求方法(GET、POST、PUT、DELETE等)和数据格式(JSON、XML、HTML等)。
因此,我们可以将Postman接口测试定义为通过使用Postman工具来验证API是否能够正确地响应预期的请求并返回正确的响应数据。