Postman 工具

序章

说到web服务接口,目前主流已经从SOAP的Web Service接口转为RESTful API接口了,所以我们主要就是讲解对REST API服务接口的测试。实际上众多开发者对REST的理解程度不同,设计出来的系统有的并非完全遵循REST风格规范。由于REST是如此的火热,大家都声称自己的系统是RESTful的。许多系统前后端接口其实就是基于HTTP的CRUD(增查改删)操作,分别使用了HTTP的POST、GET、UPDATE、DELETE方法的请求,就号称是RESTful的,我们也不必深究。只要能较好的满足目前系统的需求就行。目前支持REST API测试的工具很多。我们选取其中一种用的比较多的Postman和大家讲解一下怎样使用工具进行REST API的自动化测试。

安装和打开1.1

Postman有两种形式的产品:一种是本地应用程序,还有一种是Chrome浏览器的插件。官方推荐大家使用本地应用程序,我们也以本地应用程序Posman进行讲解。Postman的Window应用程序安装包,可以到Posman官方网站下载https://www.getpostman.com/downloads/

image.png

点击选择相应操作系统上的安装包后,就可以下载了。下载下来就是一个安装包,大家双击安装即可,安装好后,会在桌面上生成相应的图标,双击即可打开。图标如下

image.png

Postman提供了一个多窗口多标签的界面。浏览界面很简单。看下面的图

image.png

Posman分为3个部分

  • 上面的Headerbar(表头栏)

  • 左边的sidebar
    侧边栏可以让你查找和管理请求和集合。侧边栏分为两个主要便签History和Collections。
    我们在Postman应用程序中发送的每个请求都保存在“History”标签窗口中

  • 右边的Request Builder
    Request Builder 窗口是我们用来管理API请求的,构建HTTP请求消息的地方

一个简单的例子1.2

Request Builder就是用来让我们发送基于HTTP的API请求,并查看服务器的响应内容的。我们在url编辑框中输入百度的网址,如下所示

image.png

然后,点击Send按钮。随后,我们可以看到界面如下:

image.png

大家注意,红色线上方是HTTP请求消息,下方是响应消息。我们可以看出,下方给出的就是http响应的消息体内容,也就是网页显示的html文档内容。当我们点击发送按钮的时候。Postman就发出请求给百度网站服务器,百度网站服务器随后就响应了这个请求,给我们返回响应消息。Postman接收到响应消息后,显示出消息的结构给我们看。


image.png

构建http请求消息1.3

Request Builder可以帮助我们快速的构建HTTP请求。前面我们学习过HTTP请求的消息构成。HTTP请求消息中,我们可以构造的部分主要就是URL,Method(请求方法)Headers(请求头),消息体。Postman可以让我们方便的构建这些内容。

选择请求方法1.3.1

Postman里面可以非常方便的选择HTTP请求的方法。我们可以根据接口定义,选择不同的HTTP请求的方法。如下图所示

image.png

url参数的构建1.3.2

很多的时候,我们的url请求是有参数的,这里我们运行下restapi-teach系统,用管理员账号登录,进入课程管理界面。打开chrome浏览器的开发者工具栏,然后点击添加课程,在界面上输入一门课程信息。我们在开发者工具栏的网络包标签页里面可以发现,列出课程管理时,浏览器会发出一个请求如下:http://localhost/api/mgr/sq_mgr/?action=list_course&pagenum=1&pagesize=20

image.png

也可以用Fiddler

image.png

看请求消息点击Inspectors,Haders看头如果要看整个消息点击Raw(原始的消息格式)

这个就是REST API的调用,用来列出课程信息的。大家注意,这url中,问号后面的部分action=list_course&pagenum=1&pagesize=20 术语叫做query string。而这里面用&符号隔开就是一个个参数。这里包括pagenum(它的值为1)、pagesize(它的值为20)。我们可以把这个http请求直接拷贝到Postman Builder Req的地址栏里面,点击send得到如下结果:

image.png

说明我们可以直接用Postman直接发送该http请求给后端的web服务,web服务会给出响应消息,返回课程信息列表。
如果我们点击Params按钮,就可以看到Postman把url请求的参数显示在下面的表格中,如下图所示

image.png

在表格中编辑更加清晰一些。参数值是字符串,而有些字符出现在参数字符串中会有问题,比如&、空格、百分号等等,如果出现了这样的字符,我们必须要将这些字符替换成相应的转义字符,我们可以用Postman的encodeURIComponent。比如‘a b’经过转换后,就变成了‘a%20b’,也可以直接写在Params里面,比如刚刚说的例子pagesize=20&,这样写就可以了他会自动转义

image.png

如果有些字符它不进行转义的话比如=

image.png

可以强制的让他转义,选中右键点击它选择 encodeURIComponent

image.png

就可以了


image.png

请求头的构建1.1.3

有些消息需要特殊的请求头在里面,有些消息的请求头会存放session、token数据在里面,放在请求头里面的,这个时候我们可以自己构建请求头,不是所有的请求头都需要构建,常见的请求头不需要构建,比如说我们刚才发送了的几个。下面再给大家介绍一个Posman 的小技巧,点击View-->Show Postman Console他会新打开一个窗口

image.png

这个时候你发送消息点击Send他会把消息以一种好看的方式显示在这里面

image.png

比如你点Raw他也可以看到原始的消息,原始的消息里面有一部分请求的请求信息,这个请求头我并没有在Postman里面填写这些请求头,

image.png

比如accepthost这些都不是我选的,他是自动添加上去的不需要你写

假如说根据接口文档我们要添加一个username的请求头值是ql,然后添加一个password,假如必须要这两个字段在请求头里面,那你就根据文档把他加上去,编辑好以后,点击send,发送http请求中就会携带这些添加的头部

image.png

就会看到这里面多了username和password

image.png

请求体的构建1.1.4

有的时候,我们发送HTTP请求需要携带消息体。最常见的就是POST请求。restapi-teach系统,用管理员登录账号,进入课程管理页面。打开chrom浏览器的开发者工具栏,然后点击添加课程,在界面上输入一门课程的信息。

image.png

点击创建后,我们在开发者工具栏的网络包标签页里面可以发现,浏览器会发出一个POST请求。这个请求也是一个REST API,用来添加一门课程的。

image.png

Content-Length消息体字节的个数。注意他的消息体格式叫From Data就是URL encoded,决定消息体是什么格式通常在消息头里面有一个字段跟他对应的Content-Type,比如这里就是application/x-www-from-urlencoded,这种格式非常常见的请求体类型。这种格式其实跟大家讲就是他这里面消息体的格式内容如果点击view source(看原始的内容)

image.png

这个格式内容其实跟那天讲的URL参数是一样的。参数之间&隔开,然后参数名等于参数值。其实urlencoded就是我们那天讲的URL参数的格式(参数名等于参数值),只是把这个位置从URL这边移到了消息体里面了(Form Data),根据消息格式我们可以在Postman里面构建一模一样的请求,填入如下URL和Body信息,点击发送

image.png

随后刷新网页,可以发现,也能添加一门课程信息,界面如下:

image.png

Content-Type为application/x-www-from-urlencoded的这种类型的消息体,其实和前面的querystring的格式是一样,通畅,携带参数的在消息体中的REST API请求,其头部的Content-Type字段除了application/x-www-from-urlencoded外,比较常见的还有application/json(序列化)和application/xml,分别对应json格式的文本和xml格式的文本。这种情况下,用Request Builder来构造消息体,需要选择类型为raw,并且在text下拉框中选择相应的类型,并且在body编辑框中直接输入相应格式的文本。如下图所示

image.png

Collection 和 Folder作用

Web API接口是有n多个API请求和响应组成的。而这些API请求往往可以根据他们的功能相关进行分类。比如我们教管系统中的API就可以分为:课程管理API,包括课程的增删改查。老师管理API,包括老师的增删改查,培训班管理API,包括培训班管理的增删改查。学生管理API,包括学生的增删改查等。
Postman中,我们可以用Collection 和 Folder对API进行分类存放和管理。如果我们创建的API请求不存放在Collection中,缺省会放在History栏目里面,这样不是很好,不方便我们进行管理

Collection 和 Folder

在左侧边栏中,点击Collection标签,随后点击创建图标,如下图所示

image.png

随后输入Collection的名称即可。创建好的Collection会出现在下方,如下所示

image.png

我们可以在创建好的Collection,一层层的建立Folder。只需右键点击那个Collection,在弹出的菜单中选择Add Folder即可。如果要在某个Folder中建立子Folder,只需右键点击那个Folder,在弹菜单中选择Add Folder即可。通常一个产品的API接口测试,我们可以创建一个Collection和其对应。然后根据各个API的功能,分成不同的Test Suite,对应到不同的Folder中。

现在我们已经创建好文件夹了,下面我们把请求保存到文件夹中,点击save

image.png

点击之后会又API的目录让你选

image.png

这里我们可以给API起名字,比如这里我们命名为“添加课程”。缺省的话是已URL为名字,这个名字不直观。

image.png

然后点击保存,我们可以看到就保存到里面了

image.png

API还有导入导出功能,这里我们大概介绍一下

什么时候会用到导入导出呢?比如我们API请求都构建好了Collection写了很多,我们写好之后测试人员可能不止一个,假如有一天我们请假休息了,需要同事去测试,这个时候同事不需要在他的Postman重新写一遍,这个时候就需要导出来Export

image.png

可以导出到一个目录里面去,这个地方不要动他,就选择最新的就可以了,

image.png

然后点击Export选择目录就可以,下面说下怎么导入点击Import

image.png

然后点击Choose Files

image.png

选择需要导入的文件就可以了。


Postman还有一个共享的功能特别是自己共享。比如说你两个工作环境下,比如你在实验室里有一台机器,办公区域也有台机器。你在办公区域开发了一些内容,这个时候你可能带去实验室里面去用,这个时候怎么弄呢,直接拷出来放在U盘里面或者通过网络发过去这样太麻烦,这个时候可以注册一个账号,有了账号之后只要你登录同一个账号,你这个账号里面曾经创建的数据都会自定的保存起来。

点击登录


image.png

没有账号点击Create Account创建

image.png

登录之后这个账号曾经用过的信息他会同步过来

你可能感兴趣的:(Postman 工具)