python自动化（五）接口自动化：2.接口测试requests模块

一.requests介绍

• requests模块是python的第三方库，使用它我们可以非常方便的发起get，post等接口请求。并且获取接口的返回值。在自动化中我们常常使用requests模块来编写接口自动化测试用例。

• requests的官方文档为：https://docs.python-requests.org/zh_CN/latest/

二.requests详解

1.安装

pip install requests

2.常用API

2.1发送请求相关的API

(1) 发送get请求API

requests.get('https://github.com/ouyi-github/') # 不带参数
requests.get(url='http://dict.baidu.com/s', params={
   'wd':'python','from':'zici'}) # 带参数。方式1
requests.get(url='https://dict.baidu.com/s?wd=python&from=zici') # 带参数。方式2

(2)发送post请求API

r = requests.post('http://httpbin.org/post', data = {
   'key':'value'}) #以form表单形式提交数据
r = requests.post('https://api.github.com/some/endpoint', data=json.dumps({
   'some': 'data'})) # 以json形式提交数据，方式1
r = requests.post('https://api.github.com/some/endpoint', json={
   'some': 'data'}) # 以json形式提交数据，方式2

# xml格式提交数据
heards = {
   'Content-type': 'text/xml'}
XML = '<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><Request xmlns="http://tempuri.org/"><jme><JobClassFullName>WeChatJSTicket.JobWS.Job.JobRefreshTicket,WeChatJSTicket.JobWS</JobClassFullName><Action>RUN</Action><Param>1</Param><HostIP>127.0.0.1</HostIP><JobInfo>1</JobInfo><NeedParallel>false</NeedParallel></jme></Request></soap:Body></soap:Envelope>'
url = 'http://jobws.push.mobile.xxxxxxxx.com/RefreshWeiXInTokenJob/RefreshService.asmx'
r = requests.post(url=url, heards=heards, data=XML)

(3)发送其他请求API

r = requests.put('http://httpbin.org/put', data = {
   'key':'value'})
r = requests.delete('http://httpbin.org/delete')
r = requests.head('http://httpbin.org/get')
r = requests.options('http://httpbin.org/get')

2.2 获取响应相关的API

r.encoding                       #获取当前的编码
r.encoding = 'utf-8'             #设置编码
r.text                           #以encoding解析返回内容。字符串方式的响应体，会自动根据响应头部的字符编码进行解码。
r.content                        #以字节形式（二进制）返回。字节方式的响应体，会自动为你解码 gzip 和 deflate 压缩。
r.headers                        #以字典对象存储服务器响应头，但是这个字典比较特殊，字典键不区分大小写，若键不存在则返回None
r.status_code                     #响应状态码
r.raw                             #返回原始响应体，也就是 urllib 的 response 对象，使用 r.raw.read()   
r.ok                              # 查看r.ok的布尔值便可以知道是否登陆成功
 #*特殊方法*#
r.json()                         #Requests中内置的JSON解码器，以json形式返回,前提返回的内容确保是json格式的，不然解析出错会抛异常
r.raise_for_status()             #失败请求(非200响应)抛出异常
r.cookies                        # 响应中的cookies

2.3 文件上传API

url = 'http://127.0.0.1:8080/upload'
files = {
   'file': open('/home/rxf/test.jpg', 'rb')}
r = requests.post(url, files=files)

2.4 请求中添加头部信息

data = {
   'some': 'data'}
headers = {
   'content-type': 'application/json',
           'User-Agent': 'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:22.0) Gecko/20100101 Firefox/22.0'}
           
r = requests.post('https://api.github.com/some/endpoint', data=data, headers=headers)

2.5 请求中添加cookie信息

data = {
   'some': 'data'}
cookie = {
   'key':'value'}
r = requests.post('https://api.github.com/some/endpoint',data=data,cookies=cookie)

2.6 复杂数据添加到请求中

实战：企业微信添加成员API

第一步：分析企业微信接口文档

https://work.weixin.qq.com/api/doc/90000/90135/90195

第二步：将请求数据写入json文件

{
   
    "userid": "{
   {userid}}",
    "name": "{
   {name}}",
    "department": [1, 2],
    "mobile": "{
   {phone}}"
}

第三步;在代码中修改json文件内容，并作为请求的数据发送

import requests
import pystache

class TestDemo:
    def test_demo(self):
        with open('data/add_remenber.json','r',encoding='utf-8') as f:
            contect = f.read()
            rewrite = {
   
                'userid':'ojbkdsb1',
                'name':'ojbkdsbsd2',
                'phone':'13118175697'
            }
            re_contect = pystache.render(contect,rewrite) # 替换内容中的变量，contect为代替换的内容（需要为str），rewrite为替换规则
            print(re_contect)
            url = 'https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token=3pFM-B9TUPfVp1LXzADf91gnk1Nuxlr92AlyZg0QYWF0G8VnXS5OIUOykSLBhAswELF_' \
                  'IcKkZ2cWlRtaXObX0fh6KpWv4-MgdAxtZJ' \
                  'j19zqxnWlHgWQfXeB9i3zPRgVt3Ohb1WPR9kRj72O1QXy9L1z1azQGmE_2RnIIqDcChIKEorbpSWj_ez0iHchE-9dkzIHsDZoMtNDekY3RVvCkyw&debug=1'
            r = requests.post(url,data=re_contect)
            print(r.json())

这样我们可以将复杂的请求数据存放在文件中，在使用代码修改数据内容后使用。

2.7 使用响应中的复杂内容断言

在做接口自动化测试时，有时我们需要使用响应的json或者xml数据作为断言。而有些数据嵌套特别深，这时我们如果从第一层往里取这个数据，会使得表达式特别长。

这时我们可以使用json path来获取json中的数据

（1）json path

安装：

pip install jsonpath
from jsonpath import jsonpath
jsonpath(json_content,'$.store.book[0].price') # 两个参数：json_content就是json内容，'$.store.book[0].price'是jsonpath表达式

JsonPath中的“根成员对象”始终称为$，无论是对象还是数组。

JsonPath表达式可以使用点表示法

$.store.book [0].title

或括号表示法

$['store']['book'][0]['title']

函数可以在路径的尾部调用，函数的输出是路径表达式的输出，该函数的输出是由函数本身所决定的。

过滤器是用于筛选数组的逻辑表达式。一个典型的过滤器将是[?(@.age > 18)]，其中@表示正在处理的当前项目。 可以使用逻辑运算符&&和||创建更复杂的过滤器。 字符串文字必须用单引号或双引号括起来([?(@.color == ‘blue’)] 或者 [?(@.color == “blue”)]).

实例：

{
    "store": {
        "book": [
            {
                "category": "reference",
                "author": "Nigel Rees",
                "title": "Sayings of the Century",
                "price": 8.95
            },
            {
                "category": "fiction",
                "author": "Evelyn Waugh",
                "title": "Sword of Honour",
                "price": 12.99
            },
            {
                "category": "fiction",
                "author": "Herman Melville",
                "title": "Moby Dick",
                "isbn": "0-553-21311-3",
                "price": 8.99
            },
            {
                "category": "fiction",
                "author": "J. R. R. Tolkien",
                "title": "The Lord of the Rings",
                "isbn": "0-395-19395-8",
                "price": 22.99
            }
        ],
        "bicycle": {
            "color": "red",
            "price": 19.95
        }
    },
    "expensive": 10
}

2.8 jsonschema断言

（1）什么是jsonschema

JSON Schema是基于JSON格式，用于定义JSON数据结构以及校验JSON数据内容。

（2）为什么需要jsonschema断言

在实际开发过程中，接口返回的json数据十分庞大，如果我们需要对每一个数据都做断言，会导致断言代码量过大，且不灵活。

使用JSON Schema可以自动判断json数据类型是否符合我们预期

（3）使用jsonschema

第一步：编写jsonschema文件，来定义json数据类型格式

// filename = my_schema.json
{
   
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "TestInfo",
    "description": "some information about test",
    "type": "object",
    "properties": {
   
        "name": {
   
            "description": "Name of the test",
            "type": "string"
        },
        "age": {
   
            "description": "age of test",
            "type": "integer"
        }
    },
    "required": [
        "name", "age"
    ]
}

jsonschema关键字的含义和作用

type常见的取值

第二步：代码中使用jsonschema断言

import json
from jsonschema import validate
class TestDemo:
    def test_demo(self):
        # json内容
        json_content = {
   
            "name": "python",
            "age": 25
        }

        # schema文件
        with open('data/my_schema.json','r',encoding='utf-8') as f:
            my_schema = json.load(f)

        # 校验
        validate(instance=json_content,schema=my_schema) # 参数instance表示待校验的json数据，schema表示schema规则

2.9 请求中添加认证信息

一些http请求需要在请求数据中添加认证信息，才能正确响应。

那么如何在requests中添加认证信息呢？？

2.10 requests请求发送图片

以企业微信上传图片为例：

class MaterialPage(BasePage):
    """素材管理page类"""
    def up_image(self,filename):
        """
        上传图片
        :return:
        """
        filedir = os.path.join(IMAGESDIR,filename)
        with open(file=filedir,mode='rb') as f:
            file = {
   "file": f}
            r = self.requests.post("https://qyapi.weixin.qq.com/cgi-bin/media/upload?type=image",files=file)
        return r

第一步：将图片读取为二进制文件

第二步：将读取的二进制文件，存进字典中，key为“file”

第三步：将字典传递到参数files中，发送请求

转载：https://blog.csdn.net/ouyicnm/article/details/117001438