01_postman介绍和接口请求

转自 微信_吾非同  和 https://www.cnblogs.com/xiaoxi-3-/p/7839278.html 和 https://www.jianshu.com/p/fdfbf790927a

较为详细的：http://book.crifan.com/books/api_tool_postman/website/postman_func_req/get_multi_para.html

Postman简介

Postman是谷歌开发的一款网页调试和接口测试工具，能够发送任何类型的http请求，支持GET/PUT/POST/DELETE等方法。Postman非常简单易用，可以直接填写URL，header，body等就可以发送一个请求，用来测试api接口非常方便。

Postman的优点

• 使用简单，无需搭建环境，直接使用，可以快速构建请求。

• 保存以供以后回放使用。

• Postman有响应结果的断言功能，可以用来写测试用例。

• 可以把测试用例放在同一个目录下批量运行管理，可以设置迭代次数。

• 可以设置环境变量，方便测试环境和生产环境使用同一套测试用例。

• 调试结果方便查看。

安装Postman

支持chrome插件和独立应用，下方为应用下载地址。根据自己使用的操作系统，选择对应的版本。

官方下载网站：https://www.getpostman.com/apps

官方文档：https://learning.getpostman.com/docs/下载完成后，直接点击安装，首次打开会有登录页面，建议注册账号登录，这样所有历史记录和集合数据将会免费自动同步到云端，这样切换不同设备就可以快速使用历史数据了。

安装完成后界面：

接口请求流程：

最常用的请求方法有GET，POST，PUT和DELETE，它们的区别如下：

• GET请求：用于查询获取数据。

• POST请求：创建或更新数据

• PUT请求：更新数据

• DELETE请求：删除数据

HTTP请求包含四个部分：URL，方法，header头部和body主体。

 

界面整体布局如下：

工具栏

• 新建按钮：新建请求、集合、环境配置。

• 导入按钮：导入Postman文件及文件夹。

• 运行按钮：批量运行集合请求。

• 新建窗口按钮：新建一个tab窗口。

• 同步请求-同步请求数据到本地 抓包图标-使用Postman抓取API请求和cookie

• 设置图标-应用程序设置

• 通知图标-接收通知或广播

• 分享图标

• 账户管理

左侧面板

右侧面板

接口请求流程

---

一、get请求

GET请求：点击Params，输入参数及value，可输入多个，即时显示在URL链接上，所以，GET请求的请求头与请求参数如在接口文档中无特别声明时，可以不填。  https://www.baidu.com/?id=3&name=jack

get请求示例

GET响应：右上角显示响应HTTP状态码、请求的耗时。

get响应示例

需特别注意的是注意区别HTTP状态码与响应正文中的状态码，只有HTTP状态码是200时，才代表这个接口请求是正确的，这个是HTTP协议定义的，而响应正文的状态码，是程序员自已定义的，可以是200，也可以定义为其它值，是为了让接口使用者去区分正常数据与异常数据。

二、POST请求

1、POST请求一：表单提交

先看下图POST表单提交示例：

表单提交示例

上图示例中设置了请求方法，请求URL，请求参数，但没有设置请求头。有一个要明确的点是，请求头中的Content-Type与请求参数的格式之间是有关联关系的。

Content-Type与请求参数的格式之间的关联

当选择x-www-form-urlencoded的参数方式后，postman自动的帮我们设置了Content-Type，所以不需要我们人工干预，这就是使用一款流行工具的好处，把一些基础点都帮我们处理了。

2、POST请求二：json提交

先看下图json提交示例：

json提交示例

上图中，当我们选择了JSON(application/json)时，postman同样帮我们自动设置了Content-Type，可以自行的去查看Headers.

3、post请求三：xml提交

先看下图XML提交示例：

XML提交示例

上图中，当我们选择了XML(text/xml)时，postman同样帮我们自动设置了Content-Type，可以自行的去查看Headers.

4、post请求四：自行设置Content-Type

HTTP的POST请求的参数，都是放在请求正文中的，只是根据Content-Type来判断请求正文的格式，那么我们同样可以在表单提交时，选择raw，然后自行设置Content-Type为application/x-www-form-urlencoded。

POST请求的参数

自行设置Content-Type

5、POST请求五：二进制文件提交

先看下图二进制文件示例：

二进制文件提交

Body下，选择binary，在这里你可以发送视频、音频、文本等文件。

 

Tests

这个”Tests”就是我们需要处理断言的地方，postman很人性化的帮我们把断言所用的函数全给准备好了：

SNIPPETS

---

举例说明：首先设置一个断言场景，根据断言场景来举例说明Postman断言如何使用。

1、判断HTTP返回状态码为200

2、判断响应正文中是否包含："statusCode":200

3、解析响应正文，并判断statusCode的值是200，message的值是”Success”

---

---

第一步：在SNIPPETS中，往下拉，有一项”Status code:Code is 200”，这个就是为场景中的第 1 条准备的，判断HTTP返回状态码是否为200。点击这一项，可以看到在其左边，断言代码自动添加，见下图：

Status code

解释一下这句代码的意思：

tests["Status code is 200"]中的tests是一个内置对象，tests["Status code is 200"]是指为这个断言起个名称叫”Status code is 200”，这个名称可以自行修改。

responseCode.code === 200中的responseCode是内置对象，responseCode对象中有个属性是code，是指HTTP状态码的code，判断code是否为200.

综合起来，这句代码的意思是：名称为”Status code is 200”的断言中，判断responseCode对象的code属性值（HTTP状态码）是否为200。

---

第二步：同样在SNIPPETS中，找到一项”Response body:Contains string”，这个就是为场景中的第2条准备的，判断响应正文中的字段。点击后，在其左边，断言代码自动添加，见下图：

Contains string1

其中我们需要修改想要在响应报文中找到的内容：

tests["Body matches string"] = responseBody.has('"statusCode":200');    //对照第2条场景：判断响应正文中是否包含："statusCode":200

Contains string2

---

第三步：我们需要解析JSON串了，所以，在SNIPPETS中找到”Response body:JSON value check”并点击，在其左边，断言代码自动添加，见下图：

JSON value check1

我们可以看出，这里面其实是JS代码，jsonData变量其实是解析完JSON后的对象，在JS中，一个JSON对象获取其属性的值，直接是用jsonData.value，于是，我们把代码给修改一下，来判断第3条场景：

tests["response statusCode"] = jsonData.statusCode === 200;  //判断statusCode的值是200

tests["response message"] = jsonData.message === 'Success';  //判断message的值是”Success”

JSON value check2

---

这样一来，我们可以看到一共有Tests的断言4个，点击Send，发送请求，在响应区内可以看到如下图：表示断言全部通过。

---

以上，SNIPPETS中还有很多的函数提供给我们,努力学习吧~~~

---

四、管理用例---Collections

Collections集合：也就是将多个接口请求可以放在一起，并管理起来。什么样的接口请求可以放在同一个collection里？

在这里告诉大家可以这样：一个工程一个Collection，这样方便查找及统一处理数据。

第一步：创建Collections

点击上图中的带+号的图标，输入Name:”demo”，Description:”demo for Collections”，点击Create按钮即创建成功一个Collections.

Create Collections

第二步，在Collections里添加请求

在右侧准备好接口请求的所有数据，并验证后，点击save按钮。

save按钮

选择Collection及填写好Request name、Request description后，点击右下角的save to collection按钮，则该请求被添加到Collection中。

save request

添加成功后，可在左侧列表中，collection中查看刚刚添加的请求。

第三步：Collection精细化---Folder

随着放入Collection的请求越来越多，混乱就又出现了，在找一个请求时，要找半天，于是将collection中的请求分门类别就很重要了，于是，在collection中就可以添加Folder了，将相同场景的请求放入同一个Folder中，于是就实现了模块化的管理了。

点击下图中的Add Folder后，即可创建Folder。

Add Folder按钮位置

添加上Folder name，即模块名称后，点击Create，创建成功一个Folder。

add Folder

接下来，只需要把相同场景的请求拖入相同的Folder即可，这样就实现了模块化的管理了。模块化以后的结构：

模块化的管理结构

第四步：运行Collection

将工程模块化的用例管理起来后，借着这个管理起来的东风，也可以将工程模块化的用例执行起来，即一次执行一整个collection里的用例，或者执行一个collection里的某一个Folder里的用例。

点击下图中的Run：

run

下图中的”Choose collection or folder”，如果选择demo，表示运行demo这一整个collection的用例，如果选择GET，即只运行demo下的GET模块下的用例。

Environment，即运行环境，是开发环境还是测试环境，需事先配置，大家可以下去自已尝试一下。

Iterations，即重复运行次数。会将选择好的collection中folder重复运行。

Delay，间隔时间。用例与用例间的间隔时间。

Data，外部数据加载，即用例的参数化，可以与Iterations结合起来用，实现参数化，也就是数据驱动。

Run Demo，点击运行，运行完成后，即可得出一个简易的聚合报告。

第五步：Collection运行参数化

在Iterations重复运行时，如果某个用例希望每次运行时，使用不同的数据，那么应该满足如下2个条件：

1、脚本中要用到数据的地方参数化，即用一个变量来代替，每次运行时，重新获取当前的运行数据。

2、需要有一个数据池，这个数据池里的数据条数，要与重复运行的次数相同。

---

Postman的runner给我们提供了Iterations的输入项，也提供了Data的文件选择项，也就是意味着数据池是一个外部文件。

如果Iterations里的值为2，那么，这个外部文件里也应该有两条数据，postman希望我们这个外部文件里的数据是一个json（当然也可以是其它

数据格式）.

为了表示两条数据，这个json应该是一个list结构(如下图)，同时，由于脚本要用到数据的地方需要参数化，需要变量，所以，每一条数据应该就是一个map，map的key对应脚本中的变量。

外部文件里的数据

上图中表示提供了一个msg的变量，每次运行对应不同的值，预示着在脚本中可以用到msg这个变量，那在脚本中如何用？

使用变量

如上图断言中用data.msg，其中data是个内置对象，即代表每一次运行的那个map数据，所以，可以用data.msg来获取每次运行的对应的值，当然，由于是个map，也可以用data[‘msg’]来获取对应的值。

---

五、设置环境变量

有时需要在不同的环境下跑相同的测试，此时可以通过设置环境变量来动态选择。点击右上角的设置按钮-Manage Environments：

Manage Environments

填写该环境的名称：如测试环境，并在key和value中填写需要的键值。

add1

add2

使用这些键值的时候只需要加上两个花括号引用key，例如： {{url_base}}/admin/offer/

引用key

建立多个环境时，key通常都是相同的，只是value不同。创建好所有环境后，在跑用例的时候在右上角下拉列表选择需要的环境就可以了。

选择环境变量

---

六、身份验证Authentication

显示browser cookies，需要开启Interceptor。点击右上角的Interceptor 进行安装，并开启：

Interceptor

身份验证Authentication：

postman有一个helpers可以帮助我们简化一些重复和复杂的任务。当前的一套helpers可以帮助你解决一些authentication protocols的问题。

1、Basic Auth

填写用户名和密码，点击update request后，headers中自动添加Authorization。图中用户名和密码均使用的key变量：

Basic Auth

2、Digest Auth

要比Basic Auth复杂的多。使用当前填写的值生成authorization header。所以在生成header之前要确保设置的正确性。如果当前的header已经存在，postman会移除之前的header。

3、OAuth 1.0

postman的OAuth helper让你签署支持OAuth

1.0基于身份验证的请求。OAuth不用获取access token,你需要去API提供者获取的。OAuth 1.0可以在header或者查询参数中设置value。

4、OAuth 2.0

postman支持获得OAuth 2.0 token并添加到requests中。

---

---

postman竟然如此之强大！我们还有什么理由去拒绝？介绍完之后，可能新的问题又来了，如何与jenkins结合实现持续集成？

所以，产生了个newman，是个命令行运行postman请求的工具，建议大家自行去研究下，因为那确实就只是个命令行的工具而已！

作者：搁浅
出处: http://www.cnblogs.com/xiaoxi-3-/
如果对您有帮助，请关注我的同名简书:https://www.jianshu.com/u/da1677475c27
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。