当然,以上功能也只是展示了postman的一部分功能,为了能更加全面的表示这款工具的特点,我将从以下三个维度来加以解释。它们分别是:
根本功能常见类型的接口要求接口相应数据的解析接口管理(Collection)批量实行接口要求日志调试断言变量要求前置脚本接口关联常见的返回值获取便捷功能快速填写查询参数快速填写要求头信息快速实现添加一个要求如何继续凑集认证批量断言快速查询和更换高等功能读取文件进行参数化天生测试报告代码中发送要求编写接口文档mock做事监控利用事情空间代码同步与分支管理连接数据库apis一.postman安装解释postman在2018年之后就不再支持浏览器版本,以是,想要利用它就必须先下载客户端再安装利用,下面就以Windows系统为例进行安装 。
1.下载与安装
postman安装步骤:
访问postman官方网站,下载最新版本,访问地址:https://www.getpostman.com/进入到下载页面,根据自己电脑下载对应的版本双击下载的安装包,进入到安装界面,直到用户登录和注册界面。若个人利用,选择跳过即可,这时会进入到postman主界面,至此postman安装成功(下图)。若团队利用,可以进行注册,注册后利用账号可以加入团队事情区2.界面导航解释
初次利用postman的朋友可能对界面上的一些元素不太熟习,下面就通过一张图来解释这些元素的含义 。
3.发送第一个要求
如果你是第一次利用postman发送要求,下面这个例子可以作为一个最基本的入门,可以帮我们建立一个初始印象 。
打开postman,点击+加号打开一个新的要求页。在要求的URL中输入要求地址:http://www.weather.com.cn/data/sk/101010100.html点击Send按钮,这时就可以不才部的窗格中看到来自做事器的json相应数据。二.postman根本功能1.常见类型的接口要求
常见的接口有如下四种类型,分别是含有查询参数的接口,表单类型的接口,json类型的接口以及含有上传文件的接口,以下就对这四种类型接口及如何在postman中要求进行解释 。
1.1 .查询参数的接口要求
什么是查询参数?
所谓的查询参数,实在便是URL地址中问号(?)后面的部分就叫查询参数,比如:http://cx.shouji.360.cn/phonearea.php?number=13012345678 。在这个接口中,查询参数便是:number=13012345678 。而这一部分是由有键值对组成,格式为:key1=value1&key2=value2, 如果有多组键值对,要用&隔开 。
postman如何要求
在postman中实现对这类接口要求非常大略,一样平常就须要明确俩个参数即可,一个是要求方法,一个要求地址。
针对上面的那个接口,地址已经给出 ,而它的要求方法是get 。那么在postman中只须要把这俩个参数填写上即可要求 。
详细实现步骤:
打开postman,新建一个要求。在要求方法中选摘要求方法:GET,由于在postman中默认的要求方法便是GET,以是这一步可以忽略接口URL中输入地址,点击Send按钮就可以发送要求了 。解释:查询参数的URL一样平常直接拷贝到输入的URL地址栏中就可以了,当然也可以把查询参数在Params中输入,俩者的效果是一样的 。
1.2 表单类型的接口要求
什么是表单 ?
我们都知道,在发送HTTP要求的时候,一个要求中一样平常包含三个部分,分别是要求行,要求头,要求体 。
不同的接口,要求体的数据类型是不一样的,比较常见的一种便是表单类型,那么什么是表单类型呢 ? 大略理解便是在要求头中查看Content-Type,它的值如果是:application/x-www-form-urlencoded .那么就解释客户端提交的数据因此表单形式提交的 。见下图
postman中如何要求?
如果在postman要求上图的接口,我们只须要填写四个参数,分别是(可以参考上图):
要求方法:POST要求URL:http://localhost/index.php?m=Home&c=User&a=do_login&t=0.21942974229794432要求头:Content-Type:application/x-www-form-urlencode要求体: username=13088888888&password=123456&verify_code=8888实现步骤:
打开postman,新建一个要求 。在要求中设置以上四个参数,点击Send按钮。在postman中设置要求体类型为,须要选择body-> x-www-form-urlencoded查看相应数据。1.3 上传文件的表单要求
在做接口测试时,我们常常会碰着须要上传文件的接口,比如微信的更新头像。这就须要用到:multipart/form-data。它也属于一种表单,但它既支持表单要求,也支持文件上传。 它的要求报文中数据每每是下面这样的。
POST http://localhost/index.php/home/Uploadify/imageUp/savepath/head_pic/pictitle/banner/dir/images.html HTTP/1.1Content-Type: multipart/form-datafile=a1.jpg
这种类型的接口,在postman中该如何要求呢 ? 我们先剖析须要填写的参数 。
要求方法:POST要求URL:http://localhost/index.php/home/Uploadify/imageUp/savepath/head_pic/pictitle/banner/dir/images.html要求类型:multipart/form-data要求体:file=a1.jpg实现步骤:
打开postman,新建一个要求 。在要求中设置以上四个参数,点击Send按钮。把稳:在postman中设置要求体类型,须要选择body-> form-data 。file中要选择File类型,然后上传本地的文件 。查看相应数据。1.4 json类型的接口要求
这该当是接口测试中最常见的一种情形了 , 也便是要求体类型为json,我们来看下这个要求报文 。
POST http://xxx/api/sys/login HTTP/1.1Content-Type: application/json;charset=UTF-8{"account":"root","password":"123456"}
根据以上报文,我们可以剖析出,我们在postman只须要填写四个参数即可,详细如下:
要求方法:POST要求地址:http://xxx/api/sys/login要求体类型:json要求体数据:{"account":"root","password":"123456"}实现步骤:
打开postman,新建一个要求 。在要求中设置以上四个参数,点击Send按钮。把稳:在postman中设置要求体类型,须要选择body-> raw -JSON查看相应数据。2.接口相应数据解析
相应数据是发送要求后经由做事器处理后返回的结果,相应由三部分组成,分别是状态行、相应头、相应体。我们来看下postman的相应数据展示。
在postman中的相应数据展示:
状态行:Status:200 OK相应头:Headers + Cookies,须要把稳的是Cookies是包含在相应头中的,但是为了明显,工具会分开显示相应体:Body那么这些数据对我们做接口测试有什么浸染呢 ?
Body和Status是我们做接口测试的重点,一样平常来说我们都会验证相应体中的数据和相应状态码Test Results 是我们编写断言后,可以查看断言的实行结果 ,以是这个对我们也很有用 。Time 和Size 是我们做性能测试时,可以根据这两个参数来对所测接口的性能做一个大略的判断。接下来我们再来关注下Body中的几个显示主题,分别是:Pretty,Raw,Preview .
Pretty:翻译成中文便是俊秀 , 也便是说返回的Body数据在这个标签中查看 ,都是经由格式化的,格式化后的数据看起来更加直不雅观,以是postman默认展示的也是这个选项。比如返回html页面,它会经由格式化成HTML格式后展示,比如返回json,那么也会格式化成json格式展示 。
Raw:翻译成中文未经由加工的,也便是原始数据 ,原始数据一样平常都是本文格式的,未经由格式化处理的,一样平常在抓包工具中都有这个选项 。
Preview:翻译成中文便是预览,这个选项一样平常对返回HTML的页面效果特殊明显,如要求百度后返回结果,点击这个选项后就直接能查看到的页面 ,如下图 。同时这个选项和浏览器抓包中的Preview也是一样的 。
3.接口管理(Collection)
当我们对一个或多个别系中的很多用例进行掩护时,首先想到的便是对用例进行分类管理,同时还希望对这批用例做回归测试 。在postman也供应了这样一个功能,便是Collection 。通过这个Collection就可以知足我们的上面说的需求。
先对Collection功能的利用场景做个大略总结 。
用例分类管理,方便后期掩护可以进行批量用例回归测试 。那么Collection是如何去管理用例的呢 ? 先想象我们要测试一个别系,系统下有多个模块,每个模块下有很多的被测接口用例 。那么基于这个场景,我们来通过Collection来进行实现:
点击Collection,点击+New Collection,在弹出的输入框中输入Collection名称(这个就可以理解为所测试的系统)选中新建的Collection右键,点击Add Folder ,在弹出对话框中输入文件夹名称(这个就可以理解为系统中的模块)选中新建的Folder,点击Add Request ,在弹出的对话框中输入要求名称,这个便是我们所测试的接口,也可以理解为测试用例 。那么通过以上三个步骤,达到的效果便是如图所示:
总结,通过上面的操作,我们实现了一个最大略的demo模型。但实际上,有了这个功能才是postman学习的开始,由于很多功能都是根本这个功能的根本上进行的,比如用例的批量实行,Mock ,接口文档等功能 。
4. 批量实行接口要求
当我们在一个Collection中编写了很多的接口测试用例,想一起实行这批用例,在postman中是如何操作呢 ?
实现步骤:
选中一个Collection,点击右三角,在弹出的界面点击RUN这是会弹出一个叫Collection Runner的界面,默认会把Collection中的所有用例选中 。点击界面下方的RUN Collection,就会对Collection中选中的所有测试用例运行 。对上面的几个红框内的功能进行大略解释:
断言统计:左上角的两个0是统计当前Collection中断言成功的实行数和失落败的实行数,如果没有编写断言默认都为0 。Run Summary: 运行结果总览,点击它可以看到每个要求中详细的测试断言详细信息 。Export Result:导出运行结果,默认导出的结果json文件 。Retry: 重新运行,点击它会把该Collection重新运行一遍New:返回到Runner,可以重新选择用例的组合 。总体来说,这个功能紧张是用于对一个Collection中的所有用例或部分用例进行批量运行,已达到手工回归测试的目的。
5.日志调试
在做接口测试时,常常会由于代码写的有问题导致报错,这时通过查看日志就显得非常主要了,postman也供应了这样的功能,它许可我们在脚本中编写打印语句,查看打印的结果 ; 同时也可以查看每个要求的日志信息 。
在postman中编写日志打印语句利用的是JavaScript,编写的位置可以是Pre-request Script 或Tests标签中。编写打印语句如:console.log("我是一条日志")
那么打印的日如何看呢 ? 在postman中有俩个入口,第一个入口便是:view-show postman console 。
第二个入口便是左下角第三个图标 。
打开的日志界面
这里面有几个比较实用的功能:
搜索日志:输入URL或者打印的日志就能直接搜索出我们想要的要乞降日志,这对我们在浩瀚日志中查找某一条日志是非常方便的 。按级别搜索:可以查询log,info,warning,error级别的日志 ,有助于我们更快定位到缺点 。查看原始报文(Show raw log):如果习气看原始要求报文的话,这个功能可能更方便些 。隐蔽要求(Hide network):把要求都隐蔽掉,只查看输出日志 。总之,通过这个功能,我们在要求接口报错时,通过打印相应的日志,就能很轻松地找到问题缘故原由了 。
6.断言
如果没有断言,我们只能做接口的功能测试,但有了断言后,就为我们做自动化供应了条件,并且在postman中的断言是非常方便和强大的 。
我们先来理解下postman断言的一些特点 ,详细如下
断言编写位置:Tests标签断言所用措辞:JavaScript断言实行顺序:在相应体数据返回后实行 。断言实行结果查看:Test Results在上面我们先容到,编写的断言代码是JavaScript,那如果不会写怎么办 ? 不用担心,由于postman已经给我们内置了一些常用的断言 。用的时候,只需从右侧点击个中一个断言,就会在文本框中自动天生对应断言代码块 。
接下来就让我们理解一些常用断言,还是按相应的组成来划分,分别是状态行,相应头,相应体。
状态行中又包括状态码,状态 。在postman也可以对这两个进行断言
状态行中的断言:
断言状态码:Status code: code is 200pm.test("Status code is 200", function () { pm.response.to.have.status(200); //这里填写的200是预期结果,实际结果是要求返回结果});
断言状态:Status code:code name has string
pm.test("Status code name has string", function () { pm.response.to.have.status("OK"); //断言相应状态包含OK});
相应头中的断言
断言相应头中包含:Response headers:Content-Type header checkpm.test("Content-Type is present", function () { pm.response.to.have.header("Content-Type"); //断言相应头存在"Content-Type"});
断言相应体(重点)
断言相应体中包含XXX字符串:Response body:Contains stringpm.test("Body matches string", function () { pm.expect(pm.response.text()).to.include("string_you_want_to_search");}); //表明pm.expect(pm.response.text()).to.include("string") 获取相应文本中包含string
断言相应体即是XXX字符串:Response body : is equal to a string
pm.test("Body is correct", function () { pm.response.to.have.body("response_body_string");});//表明pm.response.to.have.body("response_body_string"); 获取相应体即是response_body_string
断言相应体(json)中某个键名对应的值:Response body : JSON value check
pm.test("Your test name", function () { var jsonData = pm.response.json(); pm.expect(jsonData.value).to.eql(100);});//表明var jsonData = pm.response.json() 获取相应体,以json显示,赋值给jsonData .把稳:该相应体必须返会是的json,否则会报错pm.expect(jsonData.value).to.eql(100) 获取jsonData中键名为value的值,然后和100进行比较
相应韶光(一样平常用于性能测试)
断言相应韶光:Response time is less than 200mspm.test("Response time is less than 200ms", function () { pm.expect(pm.response.responseTime).to.be.below(200); //断言相应韶光<200ms});
案例解释:
针对以下接口返回的数据进行断言:
{ "cityid": "101120101", "city": "济南", "update_time": "2020-04-17 10:50", "wea": "晴", "wea_img": "qing", "tem": "16", "tem_day": "20", "tem_night": "9", "win": "东北风", "win_speed": "3级", "win_meter": "小于12km/h", "air": "113"}
断言相应状态码为200断言city即是济南断言update_time包含2020-04-17
总结,整体来说,如果用postman做接口测试,这个断言功能必不可少,个中我们常断言的相应体包含和JSON这俩个断言又是重重之重。
7. 变量(全局/凑集/环境)
变量可以使我们在要求或脚本中存储和重复利用其值,通过将值保存在变量中,可以在凑集,环境或要求中引用。
对我们做接口测试来说,又是一个非常主要的功能 。
在postman常用的三种变量分别是全局变量,环境变量,凑集变量 。
全局变量:一旦申明了全局变量,全局有效,也便是说postman中的任何凑集,任何要求中都可以利用这个变量。它的浸染域是最大的 。环境变量:要申明环境变量,首先的创建环境,然后在环境中才能创建变量 。如果要想利用环境变量,必须先选择(导入)这个环境,这样就可以利用这个环境下的变量了 。须要解释的是环境也可以创建多个 。每个环境下又可以有多个变量 。凑集变量:凑集变量是针对凑集的,也便是说申明的变量必须基于某个凑集,它的利用范围也只是针对这个凑集有效 。个中,他们的浸染域范围依次从大到小:全局变量>凑集变量>环境变量 。 当在几个不同的范围内都申明了相同的变量时,则会优先利用范围最小的变量使。
想要利用变量中的值只需俩个步骤,分别是定义变量和获取变量 。
定义变量(设置变量)获取变量(访问变量)定义变量
定义全局变量和环境变量,点击右上角的小齿轮,弹出如下界面,就可以根据需求定义全局变量或者环境变量了。
已经定义的全局变量和环境变量,可以进行快速查看
定义凑集变量
选择一个凑集,打开查看更多动作(...)菜单,然后点击编辑 。选择“变量”选项卡以编辑或添加到凑集变量。
定义变量除了以上办法,还有其余一种办法 。但是这种办法在不同的位置定义,编写不一样。
在URL,Params , Authorization , Headers , Body中定义:手工办法创建一个空的变量名在以上的位置把想要的值选中右击,选中Set:环境|全局 ,选中一个变量名,点击后就会保存到这个变量中在Tests,Pre-requests Script:
定义全局变量:pm.collectionVariables.set("变量名",变量值)定义环境变量:pm.environment.set("变量名",变量值)定义凑集变量:pm.variables.set("变量名",变量值)获取变量
定义好变量,接下来就可以利用变量了 。须要把稳的是,在不同的位置获取变量,编写的规则也是不一样的 。
如果在要求参数中获取变量,无论是获取全局变量,还是环境变量,还是凑集变量,获取的办法都是一样的编写规则:{{变量名}} 。
要求参数指的是:URL,Params , Authorization , Headers , Body如果是在编写代码的位置(Tests,Pre-requests Script)获取变量,获取不同类型的变量,编写的代码都不相同,详细如下:
获取环境变量:pm.environment.get(‘变量名’)获取全局变量:pm.globals.get('变量名')获取凑集变量:pm.pm.collectionVariables.get.get('变量名')变量的利用场景非常广泛,比如我们后面要提到的接口关联,要求前置脚本都会利用到变量 。
8.要求前置脚本
前置脚本实在便是在Pre-requests Script中编写的JavaScript脚本,想要理解这个功能,须要先理解它的实行顺序。那么下面就来看下它的实行顺序 。
可以看出,一个要求在发送之前,会先去实行Pre Request Script(前置脚本)中的代码 。那么这个功能在实际事情中有什么浸染呢 ?
紧张场景:一样平常情形下,在发送要求前须要对接口的数据做进一步处理,就都可以利用这个功能,比如说,登录接口的密码,在发送前须要做加密处理,那么就可以在前置脚本中做加密处理,再比如说,有的接口的输入参数有一些随机数,每要求一次接口参数值都会发送变革,就可以在前置脚本中编写天生随机数的代码 。总体来说,便是在要求接口之前对我们的要求数据进行进一步加工处理的都可以利用前置脚本这个功能。
接下来通过一个案例来看下该功能是如何利用 ?
案例:
要求的登录接口URL,参数t的值哀求的规则是每次要求都必须是一个随机数。接口地址:http://localhost/index.php?m=Home&c=User&a=do_login&t=0.7102045930338428实现步骤:
在前置脚本中编写天生随机数将这个值保存成环境变量将参数t的值更换成环境变量的值 。总之,这个前置脚本对我们做接口测试也非常有用,对一些繁芜的场景,都可以利用前置脚本进行处理后再要求接口 。
9. 接口关联
在我们测试的接口中,常常涌现这种情形 。 上一个接口的返回数据是下一个接口的输入参数 ,那么这俩个接口就产生了关联。 这种关联在做接口测试时非常常见,那么在postman中,如何实现这种关联关系呢 ?
实现思路:
提取上一个接口的返回数据值,将这个数据值保存到环境变量或全局变量中不才一个接口获取环境变量或全局变量案例:
用户上传头像功能,须要用户先上传一张图片,然后会自动预览 。那么在这个过程中,会调用到俩个接口 ,第一个上传头像接口,第二个预览图像接口 。个中调用上传头像接口成功后会返回如下信息:{ "url": "/public/upload/user//head_pic//ba51d1c2f7f7b98dfb5cad90846e2d79.jpg", "title": "banner", "original": "", "state": "SUCCESS", "path": "images"}
而图像预览接口URL为:http://localhost/public/upload/user//head_pic//ba51d1c2f7f7b98dfb5cad90846e2d79.jpg 。可以看出这个接口的URL后半部分实在是上一个接口返回的url的值 。那么这俩个接口就产生了关联。那么在postman 可以通过以下三步完成这俩个接口的关联实现 。
实现步骤:
获取上传头像接口返回url的值将这个值保存玉成局变量(环境变量也可以)在图像预览中利用全局变量可以看出,接口的关联的办理方案都是用的是变量中的知识,也便是说只要你明确了要提取的值,后面便是保存该值,然后在其他接口利用该值就可以了。
10.常见返回值获取
在做接口测试时,要求接口返回的数据都是很繁芜的json数据,有着多层嵌套,这样的数据层级在postman怎么获取呢 ?
案例1:多层json嵌套, 获取user_id的值
{ "code": 0, "message": "要求成功!
", "data": { "user_id": "1252163151781167104" }}
//获取json体数据var jsonData = pm.response.json()// 获取user_id的值,通过.获取var user_id = jsonData.data.user_id
案例2:json中存在列表,获取points中的第二个元素
{ "code": 0, "message": "要求成功!
", "data": { "roles": { "api": [ "API-USER-DELETE" ], "points": [ "point-user-delete", "POINT-USER-UPDATE", "POINT-USER-ADD" ] }, "authCache": null }}
//获取json体数据var jsonData = pm.response.json()// 获取user_id的值,通过下标获取列表中某个元素var user_id = jsonData.data.roles.points[1]
案例3:列表中取末了一个元素
{ "code": 0, "message": "要求成功!
", "data": { "total": 24, "rows": [ { "id": "1066370498633486336", "mobile": "15812340003", "username": "zbz" }, { "id": "1071632760222810112", "mobile": "16612094236", "username": "llx" }, ... { "id": "1075383133106425856", "mobile": "13523679872", "username": "test001", },
//获取json体数据var jsonData = pm.response.json()// 获取id的值,通过slice(-1)获取列表中末了一个元素。var id = jsonData.data.rows.slice(-1)[0]
解释:由于平台文章规则限定,在一文中无法容纳过多的内容,故将第二部分和第三部分分成两个单独的篇幅加以发布,感兴趣的朋友可以查看后面的两篇postman文章 。