postman工具是拿来干嘛的(postman菜鸟教程)

postman工具是拿来干嘛的(postman菜鸟教程)

postman是一款支持http协议的接口调试与测试工具,其主要特点就是功能强大,使用简单且易用性好 。

无论是开发人员进行接口调试,还是测试人员做接口测试,postman都是我们的首选工具之一 。

那么接下来就介绍下postman到底有哪些功能,它们分别都能干些什么 。下面先通过一张图来直观的来看下postman中所包含的功能 。

图片

当然,以上功能也只是展示了postman的一部分功能,为了能更加全面的体现这款工具的特点,我将从以下三个维度来加以说明。它们分别是:

基础功能常见类型的接口请求接口响应数据的解析接口管理(Collection)批量执行接口请求日志调试断言变量请求前置脚本接口关联常见的返回值获取便捷功能快速填写查询参数快速填写请求头信息快速实现添加一个请求如何继承集合认证批量断言快速查询和替换高级功能读取文件进行参数化生成测试报告代码中发送请求编写接口文档mock服务监控使用工作空间代码同步与分支管理连接数据库apis一. postman安装说明

postman 在 2018 年之后就不再支持浏览器版本,所以,想要使用它就必须先下载客户端再安装使用,下面就以 Windows 系统为例进行安装 。

1. 下载与安装

postman安装步骤:

1. 访问postman官方网站,下载最新版本

2. 进入到下载页面,根据自己电脑下载对应的版本

图片

3. 双击下载的安装包,进入到安装界面,直到用户登录和注册界面。

若个人使用,选择跳过即可,这时会进入到postman主界面,至此postman安装成功(下图)。

若团队使用,可以进行注册,注册后使用账号可以加入团队工作区

图片2.界面导航说明

初次使用postman的朋友可能对界面上的一些元素不太熟悉,下面就通过一张图来说明这些元素的含义 。

图片3.发送第一个请求

如果你是第一次使用postman发送请求,下面这个例子可以作为一个最基本的入门,可以帮我们建立一个初始印象 。

http://www.weather.com.cn/data/sk/101010100.html

图片二.postman基础功能1.常见类型的接口请求

常见的接口有如下四种类型,分别是含有查询参数的接口,表单类型的接口,json类型的接口以及含有上传文件的接口,以下就对这四种类型接口及如何在postman中请求进行说明 。

1.1 .查询参数的接口请求

什么是查询参数?

而这一部分是由有键值对组成,格式为:key1=value1&key2=value2, 如果有多组键值对,要用&隔开 。

postman如何请求

具体实现步骤:

1. 打开postman,新建一个请求。

2. 在请求方法中选择请求方法:GET,因为在postman中默认的请求方法就是GET,所以这一步可以忽略

图片

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

实现步骤:

图片1.3 上传文件的表单请求

POSThttp://localhost/index.php/home/Uploadify/imageUp/savepath/head_pic/pictitle/banner/dir/images.htmlHTTP/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

实现步骤:

图片1.4 json类型的接口请求

这应该是接口测试中最常见的一种情况了 , 也就是请求体类型为json,我们来看下这个请求报文 。

POSThttp://xxx/api/sys/loginHTTP/1.1Content-Type:application/json;charset=UTF-8{“account”:”root”,”password”:”123456″}

根据以上报文,我们可以分析出,我们在postman只需要填写四个参数即可,具体如下:

实现步骤:

图片2.接口响应数据解析

响应数据是发送请求后经过服务器处理后返回的结果,响应由三部分组成,分别是状态行、响应头、响应体。我们来看下postman的响应数据展示。

图片

在postman中的响应数据展示:

状态行:Status:200 OK响应头:Headers Cookies,需要注意的是Cookies是包含在响应头中的,但是为了明显,工具会分开显示响应体:Body

那么这些数据对我们做接口测试有什么作用呢 ?

Body和Status是我们做接口测试的重点,一般来说我们都会验证响应体中的数据和响应状态码Test Results 是我们编写断言后,可以查看断言的执行结果 ,所以这个对我们也很有用 。Time 和Size 是我们做性能测试时,可以根据这两个参数来对所测接口的性能做一个简单的判断。

图片

Pretty:翻译成中文就是漂亮 , 也就是说返回的Body数据在这个标签中查看 ,都是经过格式化的,格式化后的数据看起来更加直观,所以postman默认展示的也是这个选项。比如返回html页面,它会经过格式化成HTML格式后展示,比如返回json,那么也会格式化成json格式展示 。

Raw:翻译成中文未经过加工的,也就是原始数据 ,原始数据一般都是本文格式的,未经过格式化处理的,一般在抓包工具中都有这个选项 。

图片3. 接口管理(Collection)

当我们对一个或多个系统中的很多用例进行维护时,首先想到的就是对用例进行分类管理,同时还希望对这批用例做回归测试 。在postman也提供了这样一个功能,就是Collection 。通过这个Collection就可以满足我们的上面说的需求。

先对Collection功能的使用场景做个简单总结 。

用例分类管理,方便后期维护可以进行批量用例回归测试 。

那么Collection是如何去管理用例的呢 ?先想象我们要测试一个系统,系统下有多个模块,每个模块下有很多的被测接口用例 。那么基于这个场景,我们来通过Collection来进行实现:

图片

图片

图片

那么通过以上三个步骤,达到的效果就是如图所示:

图片

总结,通过上面的操作,我们实现了一个最简单的demo模型。但实际上,有了这个功能才是postman学习的开始,因为很多功能都是基础这个功能的基础上进行的,比如用例的批量执行,Mock ,接口文档等功能 。

4. 批量执行接口请求

当我们在一个Collection中编写了很多的接口测试用例,想一起执行这批用例,在postman中是如何操作呢 ?

实现步骤:

图片

2. 这是会弹出一个叫Collection Runner的界面,默认会把Collection中的所有用例选中 。

图片

图片

对上面的几个红框内的功能进行简单说明:

总体来说,这个功能主要是用于对一个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

图片

接下来就让我们了解一些常用断言,还是按响应的组成来划分,分别是状态行,响应头,响应体。

状态行中又包括状态码,状态消息 。在postman也可以对这两个进行断言

状态行中的断言:

断言状态码:Status code: code is 200pm.test(“Statuscodeis200”,function(){pm.response.to.have.status(200);//这里填写的200是预期结果,实际结果是请求返回结果});断言状态消息:Status code:code name has stringpm.test(“Statuscodenamehasstring”,function(){pm.response.to.have.status(“OK”);//断言响应状态消息包含OK});

响应头中的断言

断言响应头中包含:Response headers:Content-Type header checkpm.test(“Content-Typeispresent”,function(){pm.response.to.have.header(“Content-Type”);//断言响应头存在”Content-Type”});

断言响应体(重点)

断言响应体中包含XXX字符串:Response body:Contains stringpm.test(“Bodymatchesstring”,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 stringpm.test(“Bodyiscorrect”,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 checkpm.test(“Yourtestname”,function(){varjsonData=pm.response.json();pm.expect(jsonData.value).to.eql(100);});//注解varjsonData = pm.response.json()获取响应体,以json显示,赋值给jsonData .注意:该响应体必须返会是的json,否则会报错pm.expect(jsonData.value).to.eql(100)获取jsonData中键名为value的值,然后和100进行比较

响应时间(一般用于性能测试)

断言响应时间:Response time is less than 200mspm.test(“Responsetimeislessthan200ms”,function(){pm.expect(pm.response.responseTime).to.be.below(200);//断言响应时间<200ms});

案例说明:

针对以下接口返回的数据进行断言:

{“cityid”:”101120101″,”city”:”济南”,”update_time”:”2020-04-1710: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中定义:

1. 手工方式创建一个空的变量名

图片

在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(前置脚本)中的代码 。那么这个功能在实际工作中有什么作用呢 ?

主要场景:一般情况下,在发送请求前需要对接口的数据做进一步处理,就都可以使用这个功能,比如说,登录接口的密码,在发送前需要做加密处理,那么就可以在前置脚本中做加密处理,再比如说,有的接口的输入参数有一些随机数,每请求一次接口参数值都会发送变化,就可以在前置脚本中编写生成随机数的代码 。

总体来说,就是在请求接口之前对我们的请求数据进行进一步加工处理的都可以使用前置脚本这个功能。

接下来通过一个案例来看下该功能是如何使用 ?

案例:

图片

实现步骤:

在前置脚本中编写生成随机数将这个值保存成环境变量将参数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体数据varjsonData=pm.response.json()//获取user_id的值,通过.获取varuser_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体数据varjsonData=pm.response.json()//获取user_id的值,通过下标获取列表中某个元素varuser_id=jsonData.data.roles.points[1]

案例3:列表中取最后一个元素

推荐好文

分享一套基于SpringBoot和Vue的企业级中后台开源项目,代码很规范!

能挣钱的,开源 SpringBoot 商城系统,功能超全,超漂亮

发表评论

登录后才能评论