接口测试 | 接口测试入门

冷不防 2022-03-25 10:54 554阅读 0赞

# 接口测试 | 接口测试入门 #

2018年02月24日 13:08:37 [立师兄Linty][Linty] 阅读数：21675

# 接口测试讲义 #

## 1. 接口测试的类型 ##

主要包含三种测试：

1.  Web接口测试，
2.  应用程序接口（API, application programming interface）测试，
3.  数据库测试。

实际上意义就是UI界面到数据库之间，数据流经过的所有过程。

LAMP（Linux Apache MySQL PHP）/LNMP（Linux Nginx MySQL PHP）：只有 Web 服务器，没有应用服务器。

*  Web 浏览器 到 Web 服务器： Web 接口测试，测试 请求和响应。
 *  Web 服务器 到 数据库服务器：应用接口测试，测试 PHP。

Linux / Windows + Java / Asp.net(C\#) + Apache/Nginx + Tomcat/IIS + MySQL/Oracle/SQL server

*  Web 浏览器 到 Web 服务器： Web 接口测试，测试 请求和响应。
 *  Web 服务器 到 应用服务器：契约服务，WebService，JavaAPI，WebAPI，WCF，.net Remoting：测试 Java 或者 C\# 处理业务逻辑（JavaEE/ ASP.NET MVC），通俗讲测试 Service。
 *  应用服务器 到 数据库服务器：数据处理服务，测试 Java 或者 C\# 处理数据，把数据读取到数据库。

我们需要关注的是 Web 接口测试。

Web 接口测试的方法：

*  Python 或者 Java，C\# 编程，触发请求，读取响应，分析得到的响应数据进行与源数据的对比。
 *  用工具：Postman 或者 SoapUI（不推荐）

Postman 原本是一个 Chrome 浏览器的插件，现在已经提供了 Windows、MacOS 和Linux 的独立安装版本。接下来用Windows的版本来进行安装和使用。

## 2. Postman 的安装 ##

1.  下载 Postman 的安装包，分为 32位 和 64位。[https://www.getpostman.com][https_www.getpostman.com]
2.  安装 Postman
3.  注册用户(Sign Up) 并登录 (Sign In)
    
    ![Snap23.png][]
4.  可以在多台电脑登录，做过的测试会自动同步。
    
    ![Snap24.png][]
5.  安装完并且登录以后可以开始测试。
    
    ![Snap25.png][]

## 3. Web 接口的测试点 ##

Web 接口通过 HTTP(S)请求，是一个URL，URL请求结果，会得到数据，数据的格式主要有两种，一种JSON，一种 XML。主要用JSON演示。

*  JSON，是JavaScript Object Notation，JavaScript 对象表示法。是用来表示JavaScript的对象，或者JavaScript数据等。因为JavaScript广泛的应用在 Web的前端页面，所以 JSON 主要应用在 Web 接口中。主要的应用场景：
    
     *  APP移动端和服务器的通信。用应用层 HTTP 协议，通过 Web接口读取数据和处理（提交）数据。
     *  Web前端与服务器的通信，往往服务器是第三方的，主要的场景就是 支付和第三方登录。
     *  京东 web端 调用 微信支付、财付通支付、支付宝支付、银联支付、网银支付。。。
     *  京东 web端 支持 微信登录、QQ登录、微博登录
     *  京东 web端 显示 第三方的的物流信息（顺丰、申通、圆通。。。）
     *  公共数据，在web端/APP端的天气预报　是由第三方接口提供。
 *  XML，Extensible Markup Language，可扩展的标记语言，HTML就是XML的一种形式，通过 标签的成对出现，以及标签的层次，来决定数据的内容。XML 主要用在后端的 应用程序接口的数据传递，比如 Java，C\#等。XML 比较旧的格式。

接下来用一个例子，来分别JSON和XML表示以下的表格数据。

<table> 
 <thead> 
  <tr> 
   <th>employee_id</th> 
   <th>first_name</th> 
   <th>last_name</th> 
   <th>email</th> 
   <th>phone_number</th> 
   <th>hire_date</th> 
   <th>job_id</th> 
   <th>salary</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>100</td> 
   <td>Steven</td> 
   <td>King</td> 
   <td>SKING</td> 
   <td>515.123.4567</td> 
   <td>6/17/1987</td> 
   <td>AD_PRES</td> 
   <td>24000</td> 
  </tr> 
  <tr> 
   <td>101</td> 
   <td>Neena</td> 
   <td>Kochhar</td> 
   <td>NKOCHHAR</td> 
   <td>515.123.4568</td> 
   <td>9/21/1989</td> 
   <td>AD_VP</td> 
   <td>17000</td> 
  </tr> 
 </tbody> 
</table>

首先用 JSON的形式，JSON是“键值对”（Key Value）的形式

{
      "employees": [{
        "employee_id": 100,
        "first_name": "Steven",
        "last_name": "King",
        "email": "SKING",
        "phone_number": "515.123.4567",
        "hire_date": "6/17/1987",
        "job_id": "AD_PRES",
        "salary": 24000
      },
      {
        "employee_id": 101,
        "first_name": "Neena",
        "last_name": "Kochhar",
        "email": "NKOCHHAR",
        "phone_number": "515.123.4568",
        "hire_date": "9/21/1989",
        "job_id": "AD_VP",
        "salary": 17000
      }]
    }

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21
 *  22

对应的 XML 格式：

<?xml version="1.0" encoding="UTF-8" ?>
    <employees>
        <employee>
            <employee_id>100</employee_id>
            <first_name>Steven</first_name>
            <last_name>King</last_name>
            <email>SKING</email>
            <phone_number>515.123.4567</phone_number>
            <hire_date>6/17/1987</hire_date>
            <job_id>AD_PRES</job_id>
            <salary>24000</salary>
        </employee>
        <employee>
            <employee_id>101</employee_id>
            <first_name>Neena</first_name>
            <last_name>Kochhar</last_name>
            <email>NKOCHHAR</email>
            <phone_number>515.123.4568</phone_number>
            <hire_date>9/21/1989</hire_date>
            <job_id>AD_VP</job_id>
            <salary>17000</salary>
        </employee>
    </employees>

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21
 *  22
 *  23

**Web 接口的定义来决定测试内容**

1.  Method：GET POST PUT DELETE
2.  URL: 接口的地址
3.  请求参数：每个参数名字，参数的类型，参数的范围，参数是否可选，参数是否有默认值
    
     *  等价类：有效等价的参数，无效等价的参数
     *  边界值：离点，上点，内点
     *  正交试验法：×因子 ×状态
     *  有的时候，参数之间关联：省，市，县（区），尤其注意非法（无效）的关联
4.  断言：检查响应的内容
    
     *  正文：正文是否包含某些字符
     *  正文：JSON 或者 XML 的键值对检查，数量检查 xx.length
     *  响应的状态码：200, 403
     *  响应的时间: 100ms, 200ms  
        \*5. 认证：你是否有权限访问接口
5.  接口的实质对象：数据
    
    1.  数据的格式
    2.  数据的内容

## 4. Postman 的使用 ##

1.  测试 心知天气 API：[https://www.seniverse.com/][https_www.seniverse.com]
    
    1.  登录 心知天气 （先注册）
    2.  读 接口的 API 文档
        
         *  API的定义： API 的URL的组成 和请求方法
         *  API的参数
         *  请求参数
         *  响应参数
    3.  以 获取实时天气作为示例：
        
        1.  API的方法和URL：GET, [https://api.seniverse.com/v3/weather/now.json][https_api.seniverse.com_v3_weather_now.json]
        2.  API的参数：
            
            1.  请求参数：
            
            <table> 
             <thead> 
              <tr> 
               <th>参数名</th> 
               <th>参数类型</th> 
               <th>参数意义</th> 
               <th>是否必选</th> 
              </tr> 
             </thead> 
             <tbody> 
              <tr> 
               <td>key</td> 
               <td>string</td> 
               <td>你的API密钥</td> 
               <td>true</td> 
              </tr> 
              <tr> 
               <td>location</td> 
               <td>string</td> 
               <td>查询的地理位置</td> 
               <td>true</td> 
              </tr> 
              <tr> 
               <td>language</td> 
               <td>string</td> 
               <td>结果表示的语言</td> 
               <td>false，默认简体中文</td> 
              </tr> 
              <tr> 
               <td>unit</td> 
               <td>string</td> 
               <td>结果表示的单位（华氏度，摄氏度）</td> 
               <td>false，默认摄氏度</td> 
              </tr> 
             </tbody> 
            </table>
            
            1.  响应参数：
            
            <table> 
             <thead> 
              <tr> 
               <th>参数名</th> 
               <th>参数类型</th> 
               <th>参数意义</th> 
              </tr> 
             </thead> 
             <tbody> 
              <tr> 
               <td>location</td> 
               <td>对象：包括id, name, country, time_zone, time_zone_offset</td> 
               <td>&nbsp;</td> 
              </tr> 
              <tr> 
               <td>now</td> 
               <td>对象：包括 text,code, temperature, feel_like…</td> 
               <td>&nbsp;</td> 
              </tr> 
              <tr> 
               <td>last_update</td> 
               <td>日期</td> 
               <td>&nbsp;</td> 
              </tr> 
             </tbody> 
            </table>
            
            1.  用Postman开始测试
            2.  new tab 中输入 方式，和URL
            3.  点击 Params 设置参数
            4.  点击 send 开始发送请求
            5.  查看请求结果是否有输出，格式是否和上述的响应参数对应
                
                    {
                     "results": [
                       {
                         "location": {
                           "id": "WS10730EM8EV",
                           "name": "Shenzhen",
                           "country": "CN",
                           "path": "Shenzhen,Shenzhen,Guangdong,China",
                           "timezone": "Asia/Shanghai",
                           "timezone_offset": "+08:00"
                         },
                         "now": {
                           "text": "Cloudy",
                           "code": "4",
                           "temperature": "25"
                         },
                         "last_update": "2017-05-09T10:05:00+08:00"
                       }
                     ]
                    }
                
                 *  1
                 *  2
                 *  3
                 *  4
                 *  5
                 *  6
                 *  7
                 *  8
                 *  9
                 *  10
                 *  11
                 *  12
                 *  13
                 *  14
                 *  15
                 *  16
                 *  17
                 *  18
                 *  19
                 *  20
            6.  编辑 Tests 页面，添加断言。
                
                    var jsonData = JSON.parse(responseBody);
                    tests["检查城市名称"] = jsonData.results[0].location.name === "Shenzhen";
                
                 *  1
                 *  2
2.  使用Postman 登录然之系统，测试登录接口
    
    1.  使用然之 4.2 或者以上版本
    2.  修改然之系统 配置文件 `C:\xampp5\htdocs\ranzhi\config\my.php`，在最后添加一行配置，如下图：
        
        ![修改 然之 配置文件][1430016-8f7ba4a57985cf14.png]
        
            $config->notEncryptedPwd = true;
        
         *  1
    3.  重启 Apache
    4.  打开 Chrome，输入然之的网址，打开登录页面
        
        ![Chrome 打开登录页面][Chrome]
    5.  打开 Fiddler，并设置 Chrome 进行抓包
    6.  在 Chrome 中进行登录，提交用户名和密码
    7.  在 Fiddler 中捕获刚刚的登录 POST 请求
        
        ![Fiddler 抓包登录 POST][Fiddler _ POST]
    8.  打开 Postman，新建 URL，POST方法。
        
        需要设置 Postman，点击 File | Settings，进行设置
        
        ![settings][]
        
        ![Setting 2][]
    9.  在 Postman 输入刚刚 Fiddler 请求的 POST 的 URL
        
        ![Fiddler 抓包分析][Fiddler]
        
        输入上述 URL
        
        ![URL][]
    10. 在 Fiddler 中复制请求的第二行到[空行][Link 1]之间的 消息报头(Head)，Postman 输入 Head
        
        ![Head 1][]
        
        ![Head2.png][]
    11. 在 Fiddler 中复制请求的正文，在 Postman 中 body 选择 raw，并输入
        
        ![输入 Body][Body]
    12. 在 Postman 的test 中输入以下测试内容：
        
        ![输入断言][1430016-e48f7bc2bba8f652.png]
        
            var jsonData = JSON.parse(responseBody);
            tests["检查locate"] = jsonData.locate === "\/sys\/index.html";
            tests["检查result"] = jsonData.result === "success";
            tests["Status code is 200"] = responseCode.code === 200;
        
         *  1
         *  2
         *  3
         *  4
    13. 在 Chrome 中退出登录，注意此步骤很重要，退出以后才能够进行 Postman 登录
        
        ![退出 然之][1430016-3a2ce1f74e1474d7.png]
    14. 在 Postman 中点击 Send，进行测试
        
        ![测试结果][1430016-a2998f5e54833a60.png]
    15. 查看 Postman 的运行结果。
        
        ![result.png][]

## 5. Web 接口的认证 ##

Web 接口测试的准备

1.  HTTP协议的请求和响应  
    请求：GET/POST  
    响应：html/JSON/XML/CSS/JavaScript/png..
2.  测试的概念  
    断言：检查返回的响应里面的内容。  
    测试设计：根据请求的参数来设计用例
3.  读懂接口的文档  
    请求的方式和URL  
    请求的参数和响应的参数
4.  在请求接口时使用认证  
    basic authorization 基础认证，输入用户名和密码

在上面四个的基础上，注意Web 接口需要认证，尤其是支付业务，这里用一个例子，并且是POST请求 + Basic Auth 认证，来阐述此部分。

示例的步骤：

1.  打开 [https://www.pingxx.com/][https_www.pingxx.com] Ping++ 在线支付网站，注册一个账号，并登录，会自动创建一个应用。
    
    ![Snap27.png][]
2.  进入自动创建的应用，进入应用的控制面板界面。
3.  获取 `APP[id]`，按如图的方式获取到，并等下使用
    
    ![Snap28.png][]
4.  获取 `Test Secret Key`，按照如图的方式获取到，并依旧等下使用
    
    ![Snap29.png][]
    
    ![Snap30.png][]
5.  按照下操作，查阅 API 文档，并开始测试。
    
    ![Snap31.png][]  
    ![Snap32.png][]  
    ![Snap33.png][]
6.  选择 Charge，创建一个 支付订单，查阅 API 文档的请求参数，响应参数，依旧 方法和URL
    
    ![Snap34.png][]
7.  在Postman 中创建新的测试，输入 POST 和 URL
    
    ![Snap35.png][]
8.  设置参数，其中需要用到 APP\[id\]，为之前步骤获取到的。
    
    ![Snap36.png][]
9.  在 请求中使用 认证，Basic Auth，输入 之前步骤获取到的 Test Secret Key，作为用户名。
    
    ![Snap37.png][]  
    ![Snap38.png][]
10. 添加测试断言。
    
    用 JavaScript脚本，查询 JSON 对象的值，并做检查。点击右侧的现成菜单，会自动生成检查 JSON 的框架。
    
        var jsonData = JSON.parse(responseBody);
        tests["检查object值"] = jsonData.object === "charge";
        tests["检查order_no值"] = jsonData.order_no === "99887766554433221100";
        tests["检查amount值"] = jsonData.amount === 9900;
    
     *  1
     *  2
     *  3
     *  4
    
    ![Snap39.png][]
11. 点击 Send 开始测试。
    
    ![Snap40.png][]
    
     *  示例2：创建红包的Web 接口测试
12. [微信红包][Link 2]支付接口测试的接口描述
    
    ![创建红包的Web接口描述][Web]
13. 在 Postman 中输入 POST 方法和 URL
    
    ![Paste\_Image.png][Paste_Image.png]
14. 在 Postman 中 使用 Http Basic Auth 认证。输入之前获取的 Secret\_test\_key。根据 API文档进行的操作
    
    ![Paste\_Image.png][Paste_Image.png 1]
    
    在 Postman 中操作
    
    ![Paste\_Image.png][Paste_Image.png 2]
    
    ![Paste\_Image.png][Paste_Image.png 3]
15. 输入 请求的参数，注意 **POST 请求的请求参数，输入到 Body 中**
    
    ![输入正文][1430016-33fbca3dcca462dc.png]
16. 在 Test 设置断言，刚才说要设置 Object 的验证。
    
    输入以下内容：
    
    ![断言][1430016-422c230f0078b5a9.png]
    
        var jsonData = JSON.parse(responseBody);
        tests["检查 Object 属性"] = jsonData.object === "red_envelope";
        tests["检查 金额 属性"] = jsonData.amount === 6000;
    
     *  1
     *  2
     *  3
17. 点击Send，检查。
    
    ![结果][1430016-8a232dbf0e757d42.png]
18. 到管理平台查看订单结果。
    
    ![Paste\_Image.png][Paste_Image.png 4]

## 6. Postman 的其他功能 ##

Postman 支持导出用例以及账户的同步功能。

![Snap41.png][]

*  接口实例：  
    天气预报接口：  
    接口URL: [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx]  
    网络服务描述语言: [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_wsdl]  
    该接口有5个方法:
    
     *  getSupportCity()
     *  getSupportDataSet()
     *  getSupportProvince()
     *  getWeatherbyCityName()
     *  getWeatherbyCityNamePro()
 *  通过输入参数，可以调用这些接口，并得到请求的数据。  
    查询本天气预报Web Services支持的国内外城市或地区信息：  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportCity?byProvinceName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportCity_byProvinceName]广东  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportCity?byProvinceName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportCity_byProvinceName]北京  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportCity?byProvinceName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportCity_byProvinceName]上海  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportCity?byProvinceName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportCity_byProvinceName]湖北  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportCity?byProvinceName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportCity_byProvinceName]河南
    
    查询获得本天气预报Web Services支持的洲、国内外省份和城市信息  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportDataSet][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportDataSet]  
    查询获得本天气预报Web Services支持的洲、国内外省份和城市信息  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportProvince][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportProvince]  
    查询获得根据城市或地区名称查询获得未来三天内天气情况、现在的[天气实况][Link 3]、天气和生活指数  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName]深圳  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=59493][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_59493]  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName]北京  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=54511][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_54511]  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName]上海  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=58367][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_58367]  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName]香港  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=45005][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_45005]  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=Chicago][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_Chicago]  
    [http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=72530][http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_72530]

## 7. Python requests 的使用 ##

Postman 作为工具，有UI的工具可以完整的操作 Web API（Application Programming Interface），有些场景，还需要在自动化测试方案中操作 Web API。对于 Python 来说有两种主流的工具操作 HTTP Web API。

*  urllib （python 自带的，但是语法反人类）
 *  requests （第三方的，但是 HTTP Request for human)，我们推荐这个 requests 工具。

和 Selenium 一样，requests 也是第三方的工具库。类比 Selenium 操作浏览器，requests 操作 HTTP 请求。

部署 requests 的过程

pip install requests

*  1

requests 有两个常见的方法

1.  requests.get()
2.  requests.post()

上面两个方法都会返回一个 Response 类的对象。注意 Response 类 属于 requests。

作为自动化接口测试工具，类似于 Selenium，我们需要 用 Page-Object 方式进行设计

*  每个 Page 写一个 URL 的功能。
    
     *  get\_realtime\_weather\_by\_ip
     *  get\_realtime\_weather\_by\_city
     *  get\_realtime\_weather\_by\_location
     *  … 单位
     *  … 语言
 *  每个 page 都不可以 直接用 requests
    
     *  封装 requests 到 box\_requests.py
     *  创建一个类，用来从封装的 box\_requests.py 中返回我们定制的 结果（响应）
 *  在每个用例中，继承 unittest.TestCase，调用 Page，进行测试
    
     *  测试用的数据还是应该抽出来，放到 csv 或者 数据库中

## 8. 简单的GET请求实例 ##

*  天气实况

[GET][] `/weather/now.json`

获取指定城市的天气实况。付费用户可获取全部数据，免费用户只返回天气现象文字、代码和气温3项数据。注：[中国][Link 4]城市暂不支持云量和露点温度。

**请求地址示例**

[https://api.seniverse.com/v3/weather/now.json?key=MJX11XSAPG&location=beijing&language=zh-Hans&unit=c][https_api.seniverse.com_v3_weather_now.json_key_MJX11XSAPG_location_beijing_language_zh-Hans_unit_c]

**参数**

*  key
    
    **你的API密钥**
 *  location
    
    **所查询的位置**参数值范围：`城市ID` 例如：location=WX4FBXXFKE4F`城市中文名` 例如：location=北京`省市名称组合` 例如：location=[辽宁][Link 5]朝阳、location=北京朝阳`城市拼音/英文名` 例如：location=beijing（如拼音相同城市，可在之前加省份和空格，例：shanxi yulin）`经纬度` 例如：location=39.93:116.40\*\*（纬度前经度在后，冒号分隔）\*\*`IP地址` 例如：location=220.181.111.86（某些IP地址可能无法定位到城市）`“ip”两个字母` 自动识别请求IP地址，例如：location=ip
 *  language
    
    **语言 (可选)**参数值范围：[点此查看][Link 6]
 *  unit
    
    **单位 (可选)**参数值范围：`c` 当参数为c时，温度c、风速km/h、能见度km、气压mb`f` 当参数为f时，温度f、风速mph、能见度mile、气压inch默认值：`c`

**返回结果 200**

{
      "results": [{
      "location": {
          "id": "C23NB62W20TF",
          "name": "西雅图",
          "country": "US",
          "timezone": "America/Los_Angeles",
          "timezone_offset": "-07:00"
      },
      "now": {
          "text": "多云", //天气现象文字
          "code": "4", //天气现象代码
          "temperature": "14", //温度，单位为c摄氏度或f华氏度
          "feels_like": "14", //体感温度，单位为c摄氏度或f华氏度
          "pressure": "1018", //气压，单位为mb百帕或in英寸
          "humidity": "76", //相对湿度，0~100，单位为百分比
          "visibility": "16.09", //能见度，单位为km公里或mi英里
          "wind_direction": "西北", //风向文字
          "wind_direction_degree": "340", //风向角度，范围0~360，0为正北，90为正东，180为正南，270为正西
          "wind_speed": "8.05", //风速，单位为km/h公里每小时或mph英里每小时
          "wind_scale": "2", //风力等级，请参考：http://baike.baidu.com/view/465076.htm
          "clouds": "90", //云量，范围0~100，天空被云覆盖的百分比 #目前不支持中国城市#
          "dew_point": "-12" //露点温度，请参考：http://baike.baidu.com/view/118348.htm #目前不支持中国城市#
      },
      "last_update": "2015-09-25T22:45:00-07:00" //数据更新时间（该城市的本地时间）
      }]
    }

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21
 *  22
 *  23
 *  24
 *  25
 *  26
 *  27

具体的步骤：

*  封装 requests 到 `box_requests.py`
    
        import requests
        from model.http_response import HttpResponse
        
        class BoxRequests:
          def get(self, url, param):
              """
              用 Get 的方式请求 URL
              :param url: 
              :param param: 参数
              :return: model 中的 HttpResponse 类的对象
              """
              r = requests.get(url, param)
              http_response = HttpResponse()
              http_response.status_code = r.status_code
              http_response.json_dict = r.json()
              return http_response
    
     *  1
     *  2
     *  3
     *  4
     *  5
     *  6
     *  7
     *  8
     *  9
     *  10
     *  11
     *  12
     *  13
     *  14
     *  15
     *  16
     *  17
 *  创建一个文件夹 model，在里面创建一个类 `HttpResponse`
    
        class HttpResponse:
          status_code = None
          json_dict = None
    
     *  1
     *  2
     *  3
 *  创建一个 page ：`senivers_realtime_weather_page.py`
    
        from base.box_requests import BoxRequests
        
        class SeniversRealtimeWeatherPage:
        
          base_url = "/weather/now.json"
        
          def get_weather_by_ip(self, host, api_key):
              """
              根据IP地址所在的地方查询天气
              :param host:
              :param api_key:
              :return: 自定义的 HttpResponse 类的对象
              """
              br = BoxRequests()
        
              # 创建一个字典，用来传参数
              param = {
                  "key": api_key,
                  "location": "ip"
              }
        
              # 用 host 和 全局 base_url 拼成 URL
              http_response = br.get(host + self.base_url, param)
              return http_response
    
     *  1
     *  2
     *  3
     *  4
     *  5
     *  6
     *  7
     *  8
     *  9
     *  10
     *  11
     *  12
     *  13
     *  14
     *  15
     *  16
     *  17
     *  18
     *  19
     *  20
     *  21
     *  22
     *  23
     *  24
     *  25
 *  创建一个 case ：`seniverse_api_tests.py`
    
        import unittest
        
        from pages.api.senivers_realtime_weather_page import SeniversRealtimeWeatherPage
    
     *  1
     *  2
     *  3
    
    class SeniverseApiTests(unittest.TestCase):  
    api\_key = None  
    page = None  
    host = None
    
    def setUp(self):  
    self.api\_key = “MJX11XSAPG”  
    self.host = “[https://api.seniverse.com/v3][https_api.seniverse.com_v3]”  
    self.page = SeniversRealtimeWeatherPage()
    
    def test\_query\_realtime\_weather\_by\_ip(self):  
    r = self.page.get\_weather\_by\_ip(self.host, self.api\_key)  
    self.assertEqual(200, r.status\_code, “状态码返回不正确！”)  
    expected\_city = “深圳”  
    actual\_city = r.json\_dict\[“results”\]\[0\]\[“location”\]\[“name”\]  
    self.assertEqual(expected\_city, actual\_city, “城市名称与ip不相符合”)
    
    if **name** == “**main**“:  
    unittest.main()
    
    “\`
    
    ## 9. 简单的 POST 请求实例 ##
    
    1.  封装 Requests.post()方法
        
        1.  传递 url
        2.  传递 data
        3.  传递 headers
    2.  创建 PingChargeCreatePage 类
        
        1.  create()
        2.  …
    3.  创建 用例
    
    示例如下：
    
    ### 创建 Charge 对象 ###
    
    请求：POST `https://api.pingxx.com/v1/charges`
    
    发起一次支付请求时需要创建一个新的 `charge` 对象，获取一个可用的支付凭据用于客户端向第三方渠道发起支付请求。如果使用测试模式的 API Key，则不会发生真实交易。当支付成功后，Ping++ 会发送 Webhooks 通知。

<table> 
 <thead> 
  <tr> 
   <th>请求参数</th> 
   <th>&nbsp;</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>order_no**REQUIRED**</td> 
   <td>商户订单号，适配每个渠道对此参数的要求，必须在商户系统内唯一。( <code>alipay</code> : 1-64 位， <code>wx</code> : 2-32 位， <code>bfb</code> : 1-20 位， <code>upacp</code> : 8-40 位， <code>yeepay_wap</code> :1-50 位， <code>jdpay_wap</code> :1-30 位， <code>qpay</code> :1-30 位， <code>cmb_wallet</code> :10 位纯数字字符串。注：除 <code>cmb_wallet</code> 外的其他渠道推荐使用 8-20 位，要求数字或字母，不允许特殊字符)。</td> 
  </tr> 
  <tr> 
   <td>app [ id ]<strong>EXPANDABLE****REQUIRED</strong></td> 
   <td>支付使用的 <code>app</code> 对象的 <code>id</code> ， <code>expandable</code> 可展开，查看 <a href="https://help.pingxx.com/article/198599" rel="nofollow">如何获取App ID</a> 。</td> 
  </tr> 
  <tr> 
   <td>channel**REQUIRED**</td> 
   <td>支付使用的第三方支付渠道。参考 <a href="https://www.pingxx.com/api#%E6%94%AF%E4%BB%98%E6%B8%A0%E9%81%93%E5%B1%9E%E6%80%A7%E5%80%BC" rel="nofollow">支付渠道属性值</a> 。</td> 
  </tr> 
  <tr> 
   <td>amount**REQUIRED**</td> 
   <td>订单总金额（必须大于0），单位为对应币种的最小货币单位，人民币为分。如订单总金额为 1 元， <code>amount</code> 为 100，么么贷商户请查看申请的借贷金额范围。</td> 
  </tr> 
  <tr> 
   <td>client_ip**REQUIRED**</td> 
   <td>发起支付请求客户端的 IPv4 地址，如: 127.0.0.1。</td> 
  </tr> 
  <tr> 
   <td>currency**REQUIRED**</td> 
   <td>三位 ISO 货币代码，目前仅支持人民币 <code>cny</code> 。</td> 
  </tr> 
  <tr> 
   <td>subject**REQUIRED**</td> 
   <td>商品的标题，该参数最长为 32 个 Unicode 字符，银联全渠道（ <code>upacp</code> / <code>upacp_wap</code> ）限制在 32 个字节。</td> 
  </tr> 
  <tr> 
   <td>body**REQUIRED**</td> 
   <td>商品的描述信息，该参数最长为 128 个 Unicode 字符，yeepay_wap 对于该参数长度限制为 100 个 Unicode 字符。</td> 
  </tr> 
  <tr> 
   <td>extra*optional*</td> 
   <td>特定渠道发起交易时需要的额外参数，以及部分渠道支付成功返回的额外参数，详细参考 <a href="https://www.pingxx.com/api#%E6%94%AF%E4%BB%98%E6%B8%A0%E9%81%93-extra-%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E" rel="nofollow">支付渠道 extra 参数说明</a> 。</td> 
  </tr> 
  <tr> 
   <td>time_expire*optional*</td> 
   <td>订单失效时间，用 Unix 时间戳表示。时间范围在订单创建后的 1 分钟到 15 天，默认为 1 天，创建时间以 Ping++ 服务器时间为准。 微信对该参数的有效值限制为 2 小时内；银联对该参数的有效值限制为 1 小时内。</td> 
  </tr> 
  <tr> 
   <td>metadata*optional*</td> 
   <td>参考 <a href="https://www.pingxx.com/api#%E5%85%83%E6%95%B0%E6%8D%AE" rel="nofollow">元数据</a> 。</td> 
  </tr> 
  <tr> 
   <td>description*optional*</td> 
   <td>订单附加说明，最多 255 个 Unicode 字符。</td> 
  </tr> 
 </tbody> 
</table>

**返回**

返回一个支付凭据 `charge` 对象。鉴于支付渠道对 `order_no` 的合法性要求，为了保证支付请求的正确处理，请务必保证对于同一支付渠道下，不同支付产品间 `order_no` 的唯一性。例如：已在微信公众号下使用的 `order_no` 则无法在微信支付以及微信公众号扫码下重复使用，该规则同样适用于其他同类渠道。如果发生错误，则会返回错误码和错误详情，详见 [错误][Link 7]。

根据 Postman 执行这个测试的情况。选择以下的数据：

*  headers
 *  data：params
    
    把上述的两个数据，变成Python 的字典传递到 requests.post() 中，
    
    检查得到的响应中的 Json 对象的值。
    
    1.  修改 box\_requests，添加 post\_json方法
        
            def post_json(self, url, data=None, json=None, **kwargs):
             """
                 用 POST 的方式请求 URL
                 :param url:
                 :param data: 提交的数据
                 :param json: 提交的 json （可选）
                 :param kwargs: 额外的参数
                 :return:
                 """
             r = requests.post(url, data, json, **kwargs)
             http_response = HttpResponse()
             http_response.status_code = r.status_code
             http_response.json_dict = r.json()
             return http_response
        
         *  1
         *  2
         *  3
         *  4
         *  5
         *  6
         *  7
         *  8
         *  9
         *  10
         *  11
         *  12
         *  13
         *  14
    2.  创建 page，为测试用例服务
        
            class PingxxChargeCreatePage:
             base_url = "/charges"
            
             def create_charge(self, host, data, headers):
                 br = BoxRequests()
            
                 # 用 host 和 全局 base_url 拼成 URL
                 http_response = br.post_json(host + self.base_url,
                                              data=data,
                                              headers=headers)
                 return http_response
        
         *  1
         *  2
         *  3
         *  4
         *  5
         *  6
         *  7
         *  8
         *  9
         *  10
         *  11
    3.  创建 test\_case
        
            import unittest
            from pages.api.pingxx_charge_create_page import PingxxChargeCreatePage
            
            class PingxxApiTests(unittest.TestCase):
             test_secret_key = None
             app_id = None
             page = None
             host = None
            
             def setUp(self):
                 self.app_id = "app_rfv1SGmPKijLnPef"
                 self.test_secret_key = "c2tfdGVzdF80bXpqelRpenpQQ0NqVEt5VEN5VGVqYlA6"
                 self.host = "https://api.pingxx.com/v1"
                 self.page = PingxxChargeCreatePage()
            
             def test_create_charge_by_wechat(self):
                 data = {
                     "order_no": "88888888666666664444444422222222",
                     "app[id]": self.app_id,
                     "channel": "wx",
                     "amount": 10000000,
                     "client_ip": "192.168.1.202",
                     "currency": "cny",
                     "subject": "iphone 999 正品行货",
                     "body": "正规的水货 iphone 8 1000台",
                     "description": "iphone 8   一打。。。。订单附加说明，最多 255 个 Unicode 字符。"
                 }
            
                 headers = {"Authorization": "Basic %s" % self.test_secret_key}
            
                 r = self.page.create_charge(self.host, data, headers)
                 self.assertEqual(200, r.status_code, "状态码返回不正确！")
                 expected_object = "charge"
                 actual_object = r.json_dict["object"]
                 self.assertEqual(expected_object, actual_object, "对象是否为支付检查失败！")
        
         *  1
         *  2
         *  3
         *  4
         *  5
         *  6
         *  7
         *  8
         *  9
         *  10
         *  11
         *  12
         *  13
         *  14
         *  15
         *  16
         *  17
         *  18
         *  19
         *  20
         *  21
         *  22
         *  23
         *  24
         *  25
         *  26
         *  27
         *  28
         *  29
         *  30
         *  31
         *  32
         *  33
         *  34
         *  35
        
        if **name** == “**main**“:  
        unittest.main()
        
        “\`

[Linty]: https://me.csdn.net/lintyleo
[https_www.getpostman.com]: https://www.getpostman.com
[Snap23.png]: /images/20220325/382ded7498544c1d8a215d928513364c.png
[Snap24.png]: /images/20220325/d8295efea5f8452e9ccab5a1825685e9.png
[Snap25.png]: /images/20220325/c3d77c1d534b42f186cdd732916d2207.png
[https_www.seniverse.com]: https://www.seniverse.com/
[https_api.seniverse.com_v3_weather_now.json]: https://api.seniverse.com/v3/weather/now.json
[1430016-8f7ba4a57985cf14.png]: /images/20220325/b620fdb1140e47cfa41d4057aa9968fb.png
[Chrome]: /images/20220325/cfb9c0ceb3404a33a8a4b99a6ce4518a.png
[Fiddler _ POST]: /images/20220325/0a030a3d011d493eb167b98ac5b41aa0.png
[settings]: /images/20220325/e188df567b6b42dd972f31846f7dcab7.png
[Setting 2]: /images/20220325/62a5de745ea44cc5beb8d4032c8d9fe8.png
[Fiddler]: /images/20220325/69147d3c270b4d13abfc1ef306b7f576.png
[URL]: /images/20220325/3e50c33edda64b68b94cf6c38f2f68af.png
[Link 1]: https://www.baidu.com/s?wd=%E7%A9%BA%E8%A1%8C&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[Head 1]: /images/20220325/1bb490b4fe974bf48ea2e474465fec6e.png
[Head2.png]: /images/20220325/a4fa579c8cd246efbf88ba6154bd4f4d.png
[Body]: /images/20220325/2e9f1d5cd8c946df83f896d91f2e80b2.png
[1430016-e48f7bc2bba8f652.png]: /images/20220325/939a67fa949444b8bfba1b374cb57e6f.png
[1430016-3a2ce1f74e1474d7.png]: /images/20220325/eb4fd75abb014801b902c4eb728ee67f.png
[1430016-a2998f5e54833a60.png]: /images/20220325/9f603a1ec5f34069a20c8564140a745e.png
[result.png]: /images/20220325/ebc784f6ab324a36a97e4963acabb4f7.png
[https_www.pingxx.com]: https://www.pingxx.com/
[Snap27.png]: /images/20220325/dc2aca9588e04f15b6be16df9b6293e9.png
[Snap28.png]: /images/20220325/e8208e6802164f58bd8daf3cd6503375.png
[Snap29.png]: /images/20220325/5a46cf7cffc84301bcd738e9de23cd70.png
[Snap30.png]: /images/20220325/fd5154a5923e4a87b3a96badc16213ae.png
[Snap31.png]: /images/20220325/c6baf4aeb62e43fca391b5c3a1ab1ea0.png
[Snap32.png]: /images/20220325/9529762fe3ed4824b1d98b0dd0680292.png
[Snap33.png]: /images/20220325/3293559742c844bba09c9614251763f4.png
[Snap34.png]: /images/20220325/640ffaa89ee44bb0946bc1a890fd6e56.png
[Snap35.png]: /images/20220325/cdfcab55b7a243b0af1c1e8b3a5920a7.png
[Snap36.png]: /images/20220325/3d5430739be546c0bd3c22ab31fa5410.png
[Snap37.png]: /images/20220325/8722a8a8103542fdb272300bc3fd195f.png
[Snap38.png]: /images/20220325/5c63036e693f40adb09450317c5a1287.png
[Snap39.png]: /images/20220325/5afeda0406374a48a930582db8932288.png
[Snap40.png]: /images/20220325/c7cd379ee32f4563b08828cf177a1150.png
[Link 2]: https://www.baidu.com/s?wd=%E5%BE%AE%E4%BF%A1%E7%BA%A2%E5%8C%85&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[Web]: /images/20220325/892df395b728490f90849ea318331770.png
[Paste_Image.png]: /images/20220325/4c3e6e1d907944cea00f7cf0271b2881.png
[Paste_Image.png 1]: /images/20220325/90e36425bbea46ca926c88b23905cf13.png
[Paste_Image.png 2]: /images/20220325/ce452b009e37491c87da75dfff7935dc.png
[Paste_Image.png 3]: /images/20220325/015f50adc6da440a9aee9cfc2886ca56.png
[1430016-33fbca3dcca462dc.png]: /images/20220325/c7517bf35d224d218df239dab02c42f1.png
[1430016-422c230f0078b5a9.png]: /images/20220325/d71e3c9c3e6b4743bdc0c6a6c236f01d.png
[1430016-8a232dbf0e757d42.png]: /images/20220325/6a654388917a4a449473968dc1b47ccb.png
[Paste_Image.png 4]: /images/20220325/626447603c8649b6a2a90f4f09f389e8.png
[Snap41.png]: /images/20220325/89ba7459bee34dfc9685cf515288ed3b.png
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_wsdl]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportCity_byProvinceName]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportCity?byProvinceName=
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportDataSet]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportDataSet
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getSupportProvince]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getSupportProvince
[Link 3]: https://www.baidu.com/s?wd=%E5%A4%A9%E6%B0%94%E5%AE%9E%E5%86%B5&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_59493]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=59493
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_54511]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=54511
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_58367]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=58367
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_45005]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=45005
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_Chicago]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=Chicago
[http_www.webxml.com.cn_WebServices_WeatherWebService.asmx_getWeatherbyCityName_theCityName_72530]: http://www.webxml.com.cn/WebServices/WeatherWebService.asmx/getWeatherbyCityName?theCityName=72530
[GET]: https://www.seniverse.com/doc#now-get
[Link 4]: https://www.baidu.com/s?wd=%E4%B8%AD%E5%9B%BD&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[https_api.seniverse.com_v3_weather_now.json_key_MJX11XSAPG_location_beijing_language_zh-Hans_unit_c]: https://api.seniverse.com/v3/weather/now.json?key=MJX11XSAPG&location=beijing&language=zh-Hans&unit=c
[Link 5]: https://www.baidu.com/s?wd=%E8%BE%BD%E5%AE%81&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[Link 6]: https://www.seniverse.com/doc#language
[https_api.seniverse.com_v3]: https://api.seniverse.com/v3
[Link 7]: https://www.pingxx.com/api#%E9%94%99%E8%AF%AF