BAT 名企大厂做接口自动化如何高效使用 Requests ？

2022 年 9 月 14 日
北京
本文字数：2585 字
阅读完需：约 8 分钟

Requests 是一个优雅而简单的 python HTTP 库，其实 python 内置了用于访问网络的资源模块，比如 urllib，但是它不如 requests 简单，优雅，而且缺少许多实用功能。接下来的接口测试的学习和实战，都与 requests 库息息相关。

Requests 官方文档：https://2.python-requests.org/en/master/ 接下来就会使用最流行的 requests 进行接口测试

requests 提供了几乎所有的 HTTP 请求构造方法，以及通过传入参数的方法，对发送的请求进行定制化的配置。可以用来应对各种不同的请求场景。pip 命令安装 requests。

pip install requests

复制代码

发送 get 请求

import requestsr = requests.get('https://api.github.com/events')

复制代码

在请求中添加 data 参数，并发送 post 请求

import requestsr = requests.post('http://httpbin.org/post', data = {'key':'value'})

复制代码

在请求中添加 data 参数，并发送 put 请求

import requestsr = requests.put('http://httpbin.org/put', data = {'key':'value'})

复制代码

发送 delete 请求

import requestsr = requests.delete('http://httpbin.org/delete')

复制代码

发送 head 请求

mport requestsr = requests.head('http://httpbin.org/get')

复制代码

发送 options 请求

import requestsr = requests.options('http://httpbin.org/get')

复制代码

也可以直接使用 request 函数，传入不同的 method，例如使用这个方法发送 get 请求

import requestsrequests.request("get", "http://www.baidu.com")

复制代码

下面的参数都是非必须参数，但是如果需要对请求做额外的定制化，则需要以下这些参数的作用。

header 参数，通过传入 dict 定制请求头

import requestsurl = 'https://api.github.com/some/endpoint'headers = {'user-agent': 'my-app/0.0.1'}r = requests.get(url, headers=headers)

复制代码

data 参数发送编码为表单形式的数据单

>>> payload = {'key1': 'value1', 'key2': 'value2'}>>> r = requests.post("http://httpbin.org/post", data=payload)>>> print(r.text)
{  ...  "form": {    "key2": "value2",    "key1": "value1"  },  ...}

复制代码

files 参数，上传文件，dict 格式。

>>> url = 'http://httpbin.org/post'>>> files = {'file': open('report.xls', 'rb')}>>> r = requests.post(url, files=files)>>> r.text
{  ...  "files": {    "file": "<censored...binary...data>"  },  ...}

复制代码

注意：建议用二进制模式(binary mode)打开文件。这是因为 Requests 可能会试图为你提供 Content-Length header，在它这样做的时候，这个值会被设为文件的字节数（bytes）。如果用文本模式(text mode)打开文件，就可能会发生错误。

timeout 参数设定超时时间（秒），到达这个时间之后会停止等待响应：

>>> requests.get('http://github.com', timeout=0.001)
Traceback (most recent call last):  File "<stdin>", line 1, in <module>requests.exceptions.Timeout:\ HTTPConnectionPool(host='github.com', port=80):\  Request timed out. (timeout=0.001)

复制代码

注意：timeout 仅对连接过程有效，与响应体的下载无关。 timeout 并不是整个下载响应的时间限制，而是如果服务器在 timeout 秒内没有应答，将会引发一个异常（更精确地说，是在 timeout 秒内没有从基础套接字上接收到任何字节的数据时），如果不设置 timeout，将一直等待。

allow_redirects 参数

控制是否启用重定向，bool 类型，选择 True 为启用，选择 False 为禁用

import requests>>> r = requests.get('http://github.com', allow_redirects=False)>>> r.status_code
301

复制代码

proxies 参数

设置代理，dict 格式，key 值为选择的协议，可以分别设置 http 请求和 https 请求的代理。

import requests
proxies = {  'http': 'http://10.10.1.10:3128',  'https': 'http://10.10.1.10:1080',}
requests.get('https://api.github.com/events', proxies=proxies)

复制代码

verify 参数可以传入 bool 值或者 string，默认为 True。

如果设置为 False 的即为忽略对 SSL 证书的验证；反之就是需要做验证；如果传入值为 string 的话，代表指定本地的证书作为客户端证书。

从本地传入证书

import requests>>> requests.get('https://github.com', verify='/path/to/certfile')

复制代码

忽略对 SSL 证书的验证

import requests>>> requests.get('https://kennethreitz.org', verify=False)

复制代码

另外三个重要参数 json、cookies、auth 则会在后面的章节进行详细的介绍。

接口请求断言是指在发起请求之后，对返回的响应内容去做判断，用来查看是否响应内容是否与规定的返回值相符。

在发起请求后，我们使用一个变量 r 存储响应的内容，也就是 Response 对象。

>>> import requests>>> r = requests.get('http://httpbin.org/get')>>> print(r)<Response [200]>>>> import requests>>> r = requests.get('http://httpbin.org/get')>>> print(r)<Response [200]>

复制代码

Response 对象有很多功能强大的方法可以调用，比如直接获取响应头，获取 Unicode 编码后的响应内容，获取二进制的响应内容，获取原始的响应内容等等。

获得响应头

>>> r.headers{'Date': 'Sun, 05 Apr 2020 16:38:09 GMT', \'Content-Type': 'application/json', \'Content-Length': '308', 'Connection': 'keep-alive',\ 'Server': 'gunicorn/19.9.0', \ 'Access-Control-Allow-Origin': '*', \ 'Access-Control-Allow-Credentials': 'true'}

复制代码

获得编码后的响应值

>>> print(r.text){  "args": {},   "data": "",   "files": {},   "form": {    "hogwarts": [      "a",       "b",       "c"    ]  },   "headers": {    "Accept": "*/*",     "Accept-Encoding": "gzip, deflate",     "Content-Length": "32",     "Content-Type": "application/x-www-form-urlencoded",     "Host": "httpbin.org",     "User-Agent": "python-requests/2.22.0",     "X-Amzn-Trace-Id": "Root=1-5e8a01e3-0913fca09ac605ccc911ccde"  },   "json": null,   "origin": "113.118.101.232",   "url": "http://httpbin.org/post"}