【 Postman 使用教程】

一、接口测试介绍1. 接口分类内部接口系统内部各功能模块之间的接口测试比较详细外部接口系统与外部系统之间的接口测试基本功能2. 接口测试的重点测试接口数据交换是否符合需求对各种异常情况的容错处理权限的控制。3. 接口测试的流程拿到接口文档没有就需要抓包熟悉接口业务熟悉接口请求四要素和响应四要素接口的鉴权方式错误码业务等。请求四要素请求方式、请求路径、请求头、请求数据。响应四要素响应码、响应信息、响应头、响应数据。编写测试用例测试点xmind并评审用例怎么测。正例正确输入接口请求四要素查看并验证接口响应数据的准确性。反例接口鉴权(鉴权码)接口参数(值)业务场景(黑名单、调用测试、分页)。使用Postman执行接口测试。通过PostmanNewmanJenkins实现接口自动化测试持续集成并输出报告进行邮件、钉钉等通知。4. 接口自动化工具Postman、Jemter、apifox类型Postman二、Postman使用流程JSON参数一般带有{}的都是json参数第一步创建项目collections1.1 首页创建项目1.2 项目详情页介绍概述可更改项目名鉴权鉴权方式很多可选脚本前置脚本Pre-request在项目启动之前运行后置脚本Post-response。变量可自定义运行第二步创建接口请求id和密码第一种传参方式Params查询字符串参数即在请求路径后以?传递的参数多个参数之间用分割它是URL的一部分是所有人都可见会自动填写。第二种传参方式Body参数不会显示在URL相对安全它包括“JSON、表单、文件”等。form-data有参数参数的值可以是文本和文件Text、File。raw多种格式可选例如Text、JavaScrip、JSON、HTML、XML等。Authorization鉴权。Headers请求头。Script脚本分为前置脚本和后置脚本。Setting设置。Cookie请求属于请求头。第三步查看响应数据Body响应数据。Cookie响应属于响应头。Headers响应头Test Results断言断言接口是否请求成功。第四步添加更多请求Request4.1接口2获取公众号已创建的标签请求参数根据接口文档内容设置如下接口只需要access_token参数。则可将1接口的响应数据token作为2接口的请求参数。4.2接口6上传文件上传文件params设置token参数body请求体设置media参数参数值选择一张图片。返回图片的网址该网址可访问。三、Postman应用1. 技术点1.1 动态参数 {{$参数名}}时间戳{{$timestamp}}一般在新增、修改时使用避免因为值重复而无法多次执行。{{参数}} 和 {{$参数}}不能有多余的空格{{参数}}是用户自定义的参数{{$参数}}是Postman内置参数。1.2 pm.response.访问不同对象响应状态相关pm.response.code200、pm.response.statusok、pm.response.reason()状态原因。响应头pm.response.headersHeaders对象、pm.response.headers.all()所有头部数组。响应体pm.response.text()原始文本、pm.response.json()json对象。响应性能pm.response.responseTime响应耗时。请求相关pm.response.request请求对象、pm.response.request.url请求URL、pm.response.request.method请求方法、…….headers请求头、…….body请求体。2. 接口关联接口关联当接口中上一个接口的返回值需要作为下一个接口的请求参数。2.1 实现接口关联json、text正则第一步获取上一个接口返回值中指定数据。方法1使用JSON对象取值保存到全局变量。有console时不会保存到globals中。// 1. 提取响应中的JSON字段。pm是postmanresponse响应数据json数据保存到变量jsonDatavarjsonDatapm.response.json();// 2. 保存为全局变量 (变量名, 变量值)pm.globals.set(baili_token,jsonData.access_token);方法2使用正则提取保存到全部变量。match[整个匹配的字符串, 捕获组的内容]// 1. 获取响应文本varresponseTextpm.response.text();// 2. 使用正则表达式匹配 或内是匹配条件 ()捕获组varmatchresponseText.match(access_token:(.*?));// (.*?)匹配.任意字符*零或多次?匹配到一个就停止// 3. 保存到全局变量pm.globals.set(baili_token,match[1]);// 存储101_……第二步使用全局变量通过{{变量名baili_token}}引用。2.2 接口关联实现数据闭环实现数据闭环创建一条信息该信息的id123存为tag_id在编辑和删除时候id由{{tag_id}}代替123对该信息进行编辑。每次创建时候tag_id指向不同的数据。使用变量指代扩展 - 设置globals变量不成功的情况pm.globals.set存储在Postman中console在JS中查找。可通过新建JS变量保存Postman变量值的方式来查看pm.global.set从JS内存变量拿到数据存储到Postman全局存储系统console.log从JS变量域中查找数据输出到控制台// 问题varjsonDatapm.response.json();// 提取响应中的JSON字段pm.globals.set(baili_token3,jsonData.access_token);// 保存为全部变量(变量名, 变量值)console.log(baili_token3)// 运行报错ReferenceError: baili_token3 is not defined回退设置变量操作// 解决方案varsavedTokenpm.globals.get(baili_token3);// 用JS变量存储Postman变量的值console.log(savedToken)// 控制台输出正常全部变量正常保存扩展 - 正则表达式 match()假设有两处 “access_token”:“……” 的结果{“access_token”: “101”, “expires_in”: 7200, “access_token”: “102”}responseText.match(‘“access_token”:“(.*?)”’)没加g返回一个数组 [整个匹配, 1个捕获组数据]。[“access_token”:“101”, “101”]responseText.match(‘/“access_token”:“(.*?)”/g’)返回一个数据 [第1个捕获数据, 第2个捕获数据][“101”, “102”]3. 全局变量和环境变量环境变量的作用域比全局变量小且只能在单一环境下使用在生产或者测试环境变量的值不同。全局变量可以在所有环境下使用。3.1 全局变量全局变量能在Postman中整个应用中都能使用的变量。创建方式代码创建pm.globals.set()手动创建globals页面。变量的组成变量名、类型、初始值、当前值。当前仅剩下“变量名、当前值”。3.2 环境变量环境变量实际工作中一套脚本希望能在开发环境、测试环境、生产环境都能测试。假设在测试、开发环境中都设置id变量存在id有不同的值在测试中id1在开发中id2。不同环境值不一样多种环境的区别IP或者域名不同。开发环境(192.168.0.100)生产环境(192.168.0.200)测试环境(api.weixin.qq.com)环境变量的使用不同环境中变量值不同。第一步添加开发环境变量和测试环境变量id。变量名一定要一样第二步同一个request和变量分别使用不同环境运行结果不同。4. 结果断言4.1 断言2个方式状态断言测通信是否成功。主要对 “响应码、响应时间、响应头进行断言” 。业务断言测功能是否符合预期。主要对 “响应数据body的内容断言”。如返回订单金额用户信息是否符合预期。4.2 Postman自带的断言自动产生断言脚本。4.3 断言的使用在请求头的Script脚本中设置// 状态断言pm.test(断言响应码为200,function(){pm.response.to.have.status(200);});//业务断言pm.test(断言响应内容包括access_token,function(){pm.expect(pm.response.text()).to.include(access_token);});4.4 动态参数的断言在断言只使用变量来做判断。第一步不能用系统的时间戳{{$timestamp}}第二步在请求之前的Scripts自己创建一个时间戳times。// 1. 创建一个变量存放当前时间vardnDate.now();// 2. 将该变量保存为全局变量pm.globals.set(times,dn);第三步将请求参数中的时间戳改为自己创建的时间戳times。第四步在请求之后的Scripts添加断言。需要通过pm.globals.get(time)获取全局变量用拼接。// 业务断言pm.test(断言标签名,function(){pm.expect(pm.response.text()).to.include(广东pm.globals.get(times));});// 拼接符号 左右可以有空格 (广东 pm.globals.get(times))4.5 全局断言在项目的Scripts中设置断言将对每个request都进行断言。5. 批量运行可选择功能测试 or 性能测试。批量处理时图片附件会出问题需要将图片上传到云端。在请求参数中5.1 接口功能测试 3种手动运行可设置运行次数、延时时间。定期运行通过CLI运行需要安装指定PostmanCLICLI命令行运行方式。【主要用于Jenkins持续集成接口自动化测试】第一步运行下列代码运行后在“%USERPROFILE%\AppData\Local\Microsoft\WindowsApps”路径下有一个Postman.exe文件C:\Users\Dongpowershell.exe-NoProfile-InputFormatNone-ExecutionPolicyAllSigned-Command[System.Net.ServicePointManager]::SecurityProtocol 3072; iex((New-Object System.Net.WebClient).DownloadString(https://dl-cli.pstmn.io/install/win64.ps1))The Postman CLI has been installed // 表示安装成功第二步配置环境变量第三步通过DOS窗口使用CLI运行。postman login --with-api-key PMAK-69b377428b9fe000017b355f-4847c7e5354e55f1c3124f221b11d8683a postman collection run46240435-48e3807e-44d5-4f2f-848d-02cb540cfa63-e46240435-4b47b01c-520d-4bc8-b1fc-1cd9bf0611625.2 接口性能测试 1种在Postman中受限一个月只能使用25次最大虚拟用户数100最大持续时间60分钟。5.3 批量运行操作流程第一步进入运行界面点击Run Collection。在左侧导航栏右侧点RUN或进入项目页面点击左上角RUN Collection。第二步选择运行类型功能 or 性能第三步设置运行参数然后点击运行 Start Run。第四步查看运行结果6. 数据驱动测试 CSVPostman不能使用 txt。6.1 数据驱动解释数据驱动通过数据驱动用例执行。即只有请求参数不同不同请求参数得到不同结果。实现方法可将数据设置好存放在一个文件中然后读取这个数据文件来执行用例实现覆盖正反例。eg登录账户和密码6.2 文件夹folder实现数据驱动创建文件夹在文件夹下复制多个request修改参数覆盖正反例。【取消勾选stop run if an error occurs】否则遇见error就会停止执行剩下request。第一条正例第二第三条分别修改grant_type和appid参数为错误值查看报错信息是否正确。6.3 csv实现数据驱动第一步根据接口参数编写csv数据文件。data.csv第二步把所有参数都改写为全局变量全局变量名称需和csv中一致。第三步选择csv文件并批量运行。不加断言问题运行时只能选择一个文件即所有接口一个数据文件而不是一个接口一个文件。第四步修改断言和提取代码。四、Postman自动化1. 加密接口测试加密方式常见加密、自定义加密、签名SIGN1.1 加密介绍加密使用的网站https://www.bejson.com/常见加密方式(1)单向加密只加密、不能解密。MD5(哈希)、SHA、HMacSHA(2)双向加密加密解密。对称加密解密使用相同密钥。AES、DES、Base64(没密钥)不对称公钥加密私钥解密。RSAPostman不支持需要自己写js脚本或调用第三方的js脚本调试。自定义加密eg使用MD5加密后在密文H后加上123再对H123进行加密生成密文S即使用密文S。1.2 Postman加密接口实战测试只需要加密不需要解密。即只需要公钥如何确保加密正确将加密前内容在加密网站进行加密并和Postman加密后的内容进行比较。MD5加密在请求之前先对内容按照要求加密再将加密后的内容设置成全局变量在请求中使用。varmd5_usernameCryptoJS.MD5(admin).toString();varmd5_passwordCryptoJS.MD5(123).toString();pm.globals.set(md5_username,md5_username);pm.globals.set(md5_password,md5_password);Base64加密varbs_usernamebtoa(admin);varbs_passwordbtoa(123);pm.globals.set(bs_username,bs_username);pm.globals.set(bs_password,bs_password);2. 旧版 NewmanAllureJenkins 自动化持续集成旧版特点能生成美观的Allure报告缺点不利于敏捷开发的快速迭代。2.1 Newmannewman是一个命令行的集合运行器允许在没有Postman CLI的情况下实现自动化持续集成。命令newman run命令的参数-e指定环境变量-g指定全局变量-d指定数据文件-n指定迭代次数-r html --reporter-html-export生成HTML报告-r allure --reporter-allure-export生成ALLUE报告。2.2 Newman的使用第一步安装 Node.js和Newman。官网安装Nodehttps://node.js.org/命令行node验证是否安装成功命令行npm install -g newman使用newman -v验证第二步导出测试用例导出全局变量和数据文件将环境变量改成项目的集合变量即可不用导环境变量。项目右键→Export导出到D:\ms文件夹中→导出全局变量在ms中→第三步运行测试用例生成HTML报告。命令行运行newman run “D:\ms\testcases.json” -g “D:\ms\globals.json” -r html --reporter-html-export “D:\ms\report.html”第四步运行测试用例生成Allure报告。下载安装JDK并配置环境变量下载安装Allure并配置变量命令行运行newman run “D:\ms\testcases.json” -g “D:\ms\globals.json” -r allure --reporter-allure-export “D:\ms\allure-results”查看alure报告allure serve allure-results2.3 Jenkins持续集成部署Jenkins可以定时执行。第一步安装Jenkins基础配置。https://blog.csdn.net/xhmico/article/details/125622955在jenkins.war所在文件夹下执行D:\安装包java -jar jenkins.war --httpPort8080访问http://localhost:8080/。【admin123】新建item→Freestyle project。第二步配置Jenkins。高级→使用自定义的工作空间D:\msBuild Steps → Execute Windows batch command →复制命令文件不带路径构建报告类型为allure。第三步点击save然后点击左上角Jenkins来到队列页面第四步执行3. 新版 PostmanCLIJenkins 自动化持续集成新版特点简化步骤方便操作。不需要导出项目适合敏捷开发中的快速迭代3.1新版Jenkins持续集成部署第一步安装Jenkins第二步配置Jenkins。只需要CLI的命令postman login --with-api-key PMAK-69b377428b9fe000017b355f-4847c7e5354e55f1c3124f221b11d8683apostman collection run46240435-48e3807e-44d5-4f2f-848d-02cb540cfa63-e46240435-4b47b01c-520d-4bc8-b1fc-1cd9bf061162第三步在Jenkins中执行Build Now。第四步在Postman的run中查看执行结果3.2 Jenkins定时执行Jenkins定时执行执行一部分的用例新建一个文件夹生成CLI即可指定执行文件夹下的用例