A06_写一个针对 PM2.5 接口的测试用例

A06_写一个针对 PM2.5 接口的测试用例

 

下面完成一个针对前文介绍过的 PM2.5 接口的测试用例。

 

确定请求方式

针对不同的请求方法，HttpRunner 用例中附加的参数也要使用不同的关键字，这里我们先简单来谈，后续章节参考源码再进行细致的分析：

• GET方式，通过URL传输请求字符串：使用 params 关键字附加请求参数
• POST方式，请求内容类型为x-www-form-urlencoded：使用 data 关键字附加请求内容

 

确定请求参数

用例的基本格式和前面访问百度的测试用例没有太大的变化，但是该接口提交的请求需要附带两个必选参数：

• city： 要获取哪个城市的空气数据
• token： 请求人的身份证明，即AppKey，此处使用公开测试用 AppKey

 

 

根据接口说明文档，目的接口使用的是 GET 请求方式，而 GET 方式提交的请求参数需要使用 params 关键字。编写用例如下：

 

 

 

 

附：JSON格式测试用例：

文件名： PM.json     编码类型： UTF-8

[
  {
    "config":{
      "name": "PM2.5 接口测试"
    }
  },
  {
    "test": {
      "name": "北京空气质量",
      "request": {
        "url": "http://www.pm25.in/api/querys/pm2_5.json",
        "method": "GET",
        "params": {
          "city":  "北京", 
          "token": "5j1znBVAsnSf5xQyNQyq"
	}
      },
      "validate":[ { "eq":["status_code", 200] } ]
    }
  }            
 ]

 

 

执行测试用例

• 打开命令行窗口，定位到 PM.json 所在目录
• 执行命令： hrun  PM.json
• 执行结果：成功

 

 

查看测试结果 —— 测试报告

执行后在 PM.json 文件同级目录下，自动生成 reports 文件夹存放本次执行的测试报告。

 

 

 

查看测试日志：

点击 “log-1” 绿色按钮，继续查看本次测试中提交请求和返回响应的详细信息

 

 

 

JSON  ——> YAML

现在我们改写一下测试用例，将 JSON 格式改写为 YAML 格式：

# YAML 编写测试用例
- config:
    name: PM2.5 接口测试

- test: 
    name: 北京空气质量
    request: 
      url: http://www.pm25.in/api/querys/pm2_5.json
      method: GET
      params: 
        city:  北京 
        token: 5j1znBVAsnSf5xQyNQyq
    validate:
      - eq: [status_code, 200]  

 

 

执行以上测试用例，依旧成功：

 

 

再次附上该接口两种不同格式用例的对比：