Postman实现数字签名,Session依赖, 接口依赖, 异步接口结果轮询

Script(JS)为Postman赋予无限可能

基于Postman 6.1.4 Mac Native版演示结合user_api_demo实现

PS 最近接到任务, 要把几种基本下单接口调试和持续集成一下, 做个常规功能验证, 研究了下发现, 不同的下单途径, 有的需要登录(Session依赖), 有的需要验签(使用数字签名的微服务), 接口中依赖很多动态数据, 如用户id, 地址id, 工单id, 当前时间等等, 而且最重要的一点, 下单接口是异步的, 只返回事件流event_key, 特别在测试环境上, 订单处理比较慢, 需要对结果进行一个较长时间的轮询, 在选型时候, 最开始觉得, 异步接口结果轮询只能用Jmeter的定时器实现, 然而个人实在不太习惯Jmeter的元件组织逻辑(拆分过碎). 遂尝试用JS + Postman进行实现.

可行性 新版Postman 增加了Pre-request Script和Test, 使用Javascript, 并且支持Collection(测试集合)/Folder(子测试集) 级别(如下图), 功能类似与其他测框架的setUp和tearDown, 相当于具有了Fixtures功能, 可以针对不同的Scope(范围)来进行准备和断言及清理. Collection(测试集合)设置

Folder(子测试集)设置, 比Collection少个Variables(变量)设置

Postman支持的JS脚本库

Lodash: 一套JS实用的方法库, 封装了很多String, Array, Object等的处理方法, 个人不太常用
cheerio: 一个Jquery的核心库, 可以方便的使用Jquery的方式获取/断言Html/XML中的数据
tv4 JSON Schema validator: 简称tv4, 先定义一个Schema(格式模板), 再验证你的JSON是否满足这种格式, 可用于断言JSON类型响应的整体格式是否正确.
CryptoJS: 加密库, 支持AES, DES, HMAC, MD5, SHA1等常用加密方式, 可用于生成加密数据或实现生成签名数据
xml2json/json2xml: xml与json格式互转

[Postman Sandbox Api参考] (https://www.getpostman.com/docs/v6/postman/scripts/postman_sandbox_api_reference)

同时, Postman的脚本中可以读取, 设置变量, 环境变量, 全局变量, 可以读取request对象(只读)和response对象(只读)的信息, 另外, 重要的是Postman的脚本中也可以组装发送接口请求(可以实现接口依赖/接口结果验证问题)

数字签名的实现

实现原理: 请求中埋好参数{{sign}}->Pre-request Script生成sign, 并设置环境变量-> 发送请求一般的延签接口都是开发给打好jar包扔给你, 自己使用Java或Jmeter调用就行, 但是, 有代码素养的测试可以自己实现签名, 这样可以更灵活.

首先, 做一下参数化, 埋一下变量, 环境中设置了appsercret的环境变量共加密脚本使用参数化签名sign

用js实现签名算法

签名算法请参考user_api_demo中delUser接口文档

Pre-request Script

1// 连接参数
2function con_params(params){
3    if(typeof(params) == "string")
4        return params;
5    else {
6        var sort_keys = Object.keys(params).sort();
7        var s = '';
8        for(var i in sort_keys) {
9            var k = sort_keys[i];
10            s += k + "=" + con_params(params[k]) + "&";
11        }
12        return s;
13    }
14}
15
16// 生成签名
17function cal_sign(appsecret,params){
18    var s = con_params(params);
19    console.log(s + "appsecret=" + appsecret);
20    return CryptoJS.MD5(s+"appsecret="+appsecret).toString();
21    
22}
23
24var appsecret= pm.environment.get("appsecret");  // 从环境变量中获取appsecret
25params = JSON.parse(request.data);  // 获取请求数据
26delete params.sign;                 // 去掉sign, 得到元素请求参数
27sign = cal_sign(appsecret, params); // 计算签名
28
29pm.environment.set("sign", sign);   // 添加为环境变量sign

用js实现签名算法

Session依赖/ 接口依赖(关联)

实现原理: Session依赖: 在Pre-request Script请求登录接口, 再发送请求时会保持Session 接口依赖: 在Pre-request Script请求依赖接口, 从接口相应中拿到需要的参数->设置为环境变量-> 请求中使用动态参数

Session依赖(需要登录) 在需要登录的接口的Pre-request Script中添加发送登录请求脚本:

1base_url = pm.environment.get("base_url");
2
3// 登录请求, Postman脚本发送表单类(urlencoded)请求方法(Baidu不到的, 官网也没有哦!)
4const loginRequest = {
5    url: base_url + '/api/user/login/',
6    method: "POST",
7    body: {
8        mode: 'urlencoded',
9        urlencoded: 'name=张三&password=123456'
10    }
11};
12pm.sendRequest(loginRequest, function (err, res) {
13    console.log(err ? err : res.text());
14});

登录脚本

接口依赖 接口依赖token, 先在请求中设置动态参数token, 在Pre-request Script中请求getToken接口, 获取token并设置环境变量参数化token Pre-request Script

1appid = pm.environment.get("appid");
2base_url = pm.environment.get("base_url");
3
4pm.sendRequest(base_url+'/api/user/getToken/?appid='+appid, function (err, res) {
5    if (err) {
6        console.log(err);
7    } else {
8        token = res.text().split("=")[1];
9        pm.environment.set("token", token);
10    }
11});

提前请求getToken接口并截取到token

异步接口结果轮询

异步接口验证是接口测试中的难点之一, 一种是带获取结果状态接口的, 这里的实现原理是, 发送接口后, 在Test中用JS的setInterval实现轮询结果

Tests

1event_key = pm.response.json().data.event_key; // 从响应中获取event_key
2base_url = pm.environment.get("admin");
3
4// getOrderResult接口
5const getOrderResult = {
6  url: base_url + '/customer/COrder/getOrderResult',
7  method: 'POST',
8  body: {
9    mode: 'urlencoded',
10    urlencoded: 'event_key='+event_key
11  }
12};
13
14var i = 0; // 计数
15
16// 封装一个发送请求方法,用于计数器调用
17function getResult(){
18    pm.sendRequest(getOrderResult, function (err, res) {
19        i += 1;
20        if(err){
21            console.log(err);
22        }
23        else{
24            msg = res.json().data.msg;
25            if(msg == 'finish' || i > 10){   // 直到msg字段由working变为finish, 设置最多轮询20次, 最多轮询一分钟
26               clearInterval(timer); 
27            }
28        }
29    });
30}
31
32timer = setInterval(getResult, 3000);  // 每s秒请求一次接口获取结果状态

轮询下单结果

更多学习资料请加添加作者微信：lockingfree获取