由于项目需要，前段时间接触了postman工具，有点空闲了，就做个笔记吧。

  一接口测试理论

项目，模块，用例id，接口名称，用例标题，请求方式，请求url，请求参数，前置条件，结果验证，请求报文，返回报文，测试结果，测试人员有登录模块，发帖模块等等，那你要发帖就必须先登录，那么这两个模块就得有交互，它就会抛出一个接口供内部系统进行调用。

 二 postman 界面功能介绍

2-1 前言

           Postman 是一个很强大的 API调试、Http请求的工具

     

            操作环境： win7 64 位

什么样的接口请求可以放在同一个collection里？

一个工程一个Collection，这样方便查找及统一处理数据

2-3 设置环境变量

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

在Postman里面：

• Environements包含global Environment，即全局的Environment，里面定义的变量在任何地方地方都可以看到
• local Environment, 里面定义的变量只有在当前Environment里面才可以看到

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

使用这些键值的时候只需要加上两个花括号引用key

举例一下变量的好处，比如你把APP部署在自己的机器上时使用的域名是localhost，而部署在服务器上时，域名就是具体的服务器ip。为了在两种不同环境上测试你的API，你在构建request的时候就需要输入不同的url，但如果你使用了变量，你就可以使用变量来复用你的url，你只需在不同的environment里面给url赋不同的值，那你的request就完全不需要变。同理，在tests里面也是一样的。这里就不赘述

环境变量可以使用在以下地方：

• URL
• URL params
• Header values
• form-data/url-encoded values
• Raw body content
• Helper fields

注意：在你要使用的变量名上附上双花括号，一个请求只能应用一个环境变量

下图"username" 和"passwd" 的value值应用了环境变量"user_pwd"，所以在body 中，只需在key对应的value那写上变量{{username}}, {{passwd}}。

2-4 Request Body

如果我们要创建的request是类似于POST，那我们就需要编辑Request Body，Postman根据body type的不同，提供了4中编辑方式：

• form-data
• x-www-form-urlencoded
• raw
• binary

1. form-data

对应着http请求中的Content-Type为multipart/form-data. 

它会将表单的数据处理为一条消息，以标签为单元，用分隔符分开。既可以上传键值对，也可以上传文件File。

当上传的字段是文件时，会有Content-Type来表名文件类型；content-disposition，用来说明字段的一些信息；

因为multipart/form-data类型有boundary隔离，可以上传多个文件，也可以上传键值对，它采用了键值对的方式。

2. x-www-form-urlencoded
     application/x-www-from-urlencoded,会将表单内的数据转换为键值对，比如,name=Java&age = 23
3. raw（支持各种原生的类型）
4. binary（二进制 ）
通过上图可以看出,只能上传一个图片, 相当于Content-Type:application/octet-stream

2-5 Pre-request Script 

定义我们在发送request之前需要运行的一些脚本，应用场景主要是设置全局变量和环境变量

2-6 Tests （断言）

一个完整的接口测试，包括：请求->获取响应正文->断言，我们已经知道了请求与获取响应正文，如何用postman进行断言呢。

Tests

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

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

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

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

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

第一步：

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

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

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条准备的，判断响应正文中的字段。点击后，在其左边，断言代码自动添加，见下图：

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

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

第三步：

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

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

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

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

如何处理大量重复的断言逻辑

针对单个API，去编写对应的断言脚本，这个是没有什么问题的。

但是如果是针对一个项目的所有API去编写，类似于判断statusCode这样的断言就会显得很溶于，所以PostMan也考虑到了这点。

在我们创建的Collection以及下层的文件夹中，我们可以直接编写针对这个目录下的所有请求的断言脚本

这里的脚本会作用于目录下所有的请求。

这样我们就可以将一些通用性的断言挪到这里了，在每个请求的Tests下编写针对性的断言脚本

1. Tests 作为测试用例的应用
Tests 主要用来设计用例，比如要测试返回结果是否含有某一字符串，就可以用到 Tests。以gold_add 接口为例，来编写测试用例，分别测试返回的结果是否含有，如下所示：

响应成功返回PASS, 失败返回FAIL。

常用tests如下：
1.检查response body中是否包含某个string
tests["Body matches string"] = responseBody.has("string_you_want_to_search");

注意："Body matches string" 需唯一。

2.检测JSON中的某个值是否等于预期的值

var data = JSON.parse(responseBody);
tests["Your test name"] = data.value === 100;
JSON.parse()方法，把json字符串转化为对象。parse()会进行json格式的检查是一个安全的函数。 
如：检查json中某个数组元素的个数(这里检测programs的长度)
var data = JSON.parse(responseBody);
tests["program's lenght"] = data.programs.length === 5;
3.检查response body是否与某个string相等
4.转换XML body为JSON对象
var jsonObject = xml2Json(responseBody);
tests["Body is correct"] = responseBody === "response_body_string";
5.测试response Headers中的某个元素是否存在(如:Content-Type)
tests["Content-Type is present"] = postman.getResponseHeader("Content-Type"); 
//getResponseHeader()方法会返回header的值，如果该值存在
或者： 
tests["Content-Type is present"] = responseHeaders.hasOwnProperty("Content-Type");
上面的方法，不区分大小写。下面的方法，要区分大小写。

6.验证Status code的值
tests["Status code is 200"] = responseCode.code === 200;

7.验证Response time是否小于某个值
tests["Response time is less than 200ms"] = responseTime < 200;

8.name是否包含某个值
tests["Status code name has string"] = responseCode.name.has("Created");

9.POST 请求的状态响应码是否是某个值
tests["Successful POST request"] = responseCode.code === 201 || responseCode.code === 202;

10.很小的JSON数据验证器
var schema = {
"items": {
"type": "boolean"
}
};
var data1 = [true, false];
var data2 = [true, 123];
console.log(tv4.error);
tests["Valid Data1"] = tv4.validate(data1, schema);

tests["Valid Data2"] = tv4.validate(data2, schema);

2-7发送请求，get,post

接口测试中常用的请求为GET 和POST，以下均以这两种请求为例。

GET 和POST 的区别：
GET 使用URL 或Cookie 传参，而POST将数据放在Body 中。
GET的URL 在长度上会有限制，而POST没有。
POST比GET相对安全，因为在地址栏不可见。

一般POST请求用来获取数据，POST请求用来发送数据。

1.get请求

平常我们拿一个url 访问页面，就是所谓的get 请求。

2. POST请求：
POST 请求不能像GET一样直接在浏览器输入就可以请求，需要借助工具来完成。
 使用方法：选择请求方式为post，输入请求的url，以及输入必要的"Authorization" , "header" 和"Body" 数据。post请求可以发送key-value, json格式，file等。
对于"Authorization"的使用，遇到比较多的是Type 为"Basic Auth", 然后设置对应的Username 和Password。

这里的username, password的值可以通过设置环境变量的方式取得。

a. 用Postman 发送key-value 的请求：
以login 接口为例，在Body 中选取"form-data" 格式，输入所需的key-value, 选取对应的环境变量。

b. 用Postman 发送json格式的请求：

以add user 接口为例，在Body 中选取"raw" 格式，根据接口文档输入json 数据， 有需要应用环境变量的选取环境变量。

c. 用Postman 发送文件的请求：

以file upload 接口为例，在Body 中选取"form-data" 格式，在key 里输入"file"，在右边的下拉里选取类型为"File"，点击"Choose Files" 就可以上传本地文件了。