python利用requests库进行接口测试的方法详解
之前介绍了接口测试中需要关注得测试点，现在我们来看看如何进行接口测试，现在接口测试工具有很多种，例如：postman,soapui,jemter等等，对于简单接口而言，或者我们只想调试一下，使用工具是非常便捷而且快速得，但是对于更复杂得场景，这些工具虽然也能实现，但是难度要比写代码更大，而且定制化受到工具得功能影响，会
遇到一些障碍，当然我们还要实现自动化等等，鉴于以上因素，我们还是要学会使用代码进行接口测试，便于维护与扩展，或者算是我们知识得补充把~
requests库是python用来发起http/https请求得第三方库，支持get,post,put,delete等，requests特点是简单便捷、功能丰富，能够满足日常测试需求，所以我们选取requests库进行接口测试
运行环境：
- 系统:mac os 10.13.5
- python:3.6.4
- requests:2.19.1
接口为自己编写得测试接口，测试请使用自己得接口
第一部分：安装
1.安装python(自行安装)，不会的朋友们可以参考这篇文章：https://www.jb51.net/article/112486.htm
2.安装requests(linux和mac os可能会遇到权限问题，sudo安装即可)
|
1
|
pip
install
-U requests
|
3.验证
|
1
2
3
4
5
6
|
localhost:~ mac$ python3
Python 3.6.4 (v3.6.4:d48ecebad5, Dec 18 2017, 21:07:28)
[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin
Type
"help"
,
"copyright"
,
"credits"
or
"license"
for
more
information.
>>>
import
requests
>>>
|
没有报错说明python与requests环境都没问题
第二部分：基础部分
以一个简单的get接口为例
|
1
2
|
import
requests
#导入requests模块
response
=
requests.get(
"http://localhost:5000/hello"
)
#对hello接口进行get请求,并获取响应信息
|
1.响应信息（response）解析
|
1
2
3
4
5
|
print
(response.text)
print
(response.content)
##输出
你好
b
'\xe4\xbd\xa0\xe5\xa5\xbd'
|
response.text是以str得形式返回得响应信息
response.content是以bytes形式返回
实际使用中根据自己得情况进行选择
2.获取状态码
|
1
2
3
|
print
(response.status_code)
##输出
200
|
3.获取headers信息
|
1
2
3
|
print
(response.headers)
##输出
{
'Content-Type'
:
'text/html; charset=utf-8'
,
'Content-Length'
:
'6'
,
'Server'
:
'Werkzeug/0.14.1 Python/3.6.4'
,
'Date'
:
'Sun, 24 Jun 2018 02:55:27 GMT'
}
|
4.获取cookies信息
|
1
2
3
|
print
(response.cookies)
##输出
|
注意：这里与其他部分稍有不同，返回cookies的信息为cookies对象，而不是像前面部分返回得是字符串或者字典，cookies解析部分在后面会进行单独说明
5.获取请求url
|
1
2
3
|
print
(response.url)
###输出
http:
/
/
localhost:
5000
/
hello
|
6.获取反序列化后的得信息：
|
1
2
3
|
print
(response.json())
###输出：
{
'name'
:
'john'
}
|
注意：只有在返回信息为json格式时才能使用，否则会报json异常
7.获取响应时间
|
1
2
3
4
5
6
7
8
9
|
print
(response.elapsed)
print
(response.elapsed.microseconds)
print
(response.elapsed.seconds)
print
(response.elapsed.total_seconds())
##输出
0
:
00
:
00.003773
3773
0
0.003773
|
第三部分：进阶部分
通常我们要想获取正确得响应信息需要传递一些参数，针对不同得请求，传参方式稍有不通，下面我们来看一下
这里我部署了一个get接口和一个post接口，功能都是讲获取得请求参数返回回来，以便我们查看效果
1.get请求传递参数
|
1
2
3
4
5
6
7
|
params
=
{
"name"
:
"john"
,
"age"
:
17
}
response
=
requests.get(
"http://localhost:5000/get_params"
,params
=
params)
print
(response.text)
print
(response.url)
##输出
{
"name"
:
"john"
,
"age"
:
"17"
}
http:
/
/
localhost:
5000
/
get_params?name
=
john&age
=
17
|
说明：
这里做了三件事，先定义一个参数字典p，然后将参数字典以params参数传递给get方法，最后将响应信息打印出来，从响应信息可以看到参数被正确得传递进去，requests帮我们把参数组合到了url里面
2.post请求传递参数
post传递参数和get有所不同，根据服务端取值方式进行不同方式得传递
如果是传递得json格式得参数
|
1
2
3
4
5
|
p
=
{
"name"
:
"john"
,
"age"
:
17
}
response
=
requests.post(
"http://localhost:5000/post_params"
,json
=
p)
print
(response.text)
###输出：
{
"name"
:
"john"
,
"age"
:
17
}
|
如果是以html中form得形式传递参数，
|
1
2
|
response
=
requests.post(
"http://localhost:5000/post_params"
,data
=
p)
print
(response.text)
|
如果form传递得是json格式需要以下面得方式
|
1
2
3
|
import
json
response
=
requests.post(
"http://localhost:5000/post_params"
,data
=
json.dumps(p))
print
(response.text)
|
说明：
需要将字典行驶得参数转换为json格式，再进行传递
根据服务端得情况选中一种方式进行传递参数，通常情况下这三种情况可以满足测试需求
第四部分：高级部分
1.操作cookies
有时候由于服务端需要取得cookies信息来进行用户身份验证， 或者另外一些用户信息来进行逻辑处理，这时候我们在测试接口时需要手动获取cookies信息和添加cookies信息到请求中
先看设置cookies信息
注：我这里部署了一个set_cookies接口，将cookies信息作为响应信息返回
|
1
2
3
4
5
|
my_cookies
=
{
"name"
:
"john"
}
response
=
requests.get(
"http://localhost:5000/set_cookies"
,cookies
=
my_cookies)
print
(response.text)
##输出
{
"name"
:
"john"
}
|
说明：
这段代码先定义了一个cookies字典，然后通过get方法，以cookies参数传入，最后打印出响应信息，可以看到cookies被成功种入请求中
我们再说说如何获取cookies并解析cookies信息
注：这里我部署了一个get_cookies接口，将{"name":"john"}作为cookies置入响应中
|
1
2
3
4
5
|
response
=
requests.get(
"http://localhost:5000/get_cookies"
)
cookies
=
response.cookies
print
(cookies[
"name"
])
##输出：
john
|
说明：
获取cookies对象得信息，我们只需要像获取字段得value一样即可，可以看到我们成功获取到了john
2.headers
看完了cookies之后，header就一目了然了，但是我还是同样部署两个接口（一个set_headers,一个get_headers）
|
1
2
3
4
5
6
7
8
9
10
|
#设置headers
my_headers
=
{
"name"
:
"john"
}
response
=
requests.get(
"http://localhost:5000/set_headers"
,headers
=
my_headers)
print
(response.text)
#获取headers
response
=
requests.get(
"http://localhost:5000/get_headers"
)
print
(response.headers.get(
"name"
))
##输出：
{
"name"
:
"john"
}
john
|
3.session
session可以理解为一段对话，而这段对话会纪录这次会话中得一些内容和状态，当中断这段对话，这些信息与状态就丢失了session对象让你能够跨请求保持某些参数。它也会在同一个 Session 实例发出的所有请求之间保持 cookie， 期间使用 urllib3 的 connection pooling 功能。所以如果你向同一主机发送多个请求，底层的 TCP 连接将会被重用，从而带来显著的性能提升
使用方法
注：我这里部署两个接口，一个hello接口（用来演示使用全局cookies,将请求cookies返回），一个world接口（用来演示使用全局headers,将请求headers返回）
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
#设置headers
my_info
=
{
"name"
:
"john"
}
#创建全局session对象
my_session
=
requests.session()
#设置全局cookies信息
my_session.cookies.
set
(
"name"
,
"john"
)
#设置全局headers信息
my_session.headers.update(my_info)
#演示全局cookies使用
response
=
my_session.get(
"http://localhost:5000/hello"
)
print
(response.text)
#演示全局headers使用
response
=
my_session.get(
"http://localhost:5000/world"
)
print
(response.text)
##输出
{
"name"
:
"john"
}
{
"Host"
:
"localhost:5000"
,
"User-Agent"
:
"python-requests/2.19.1"
,
"Accept-Encoding"
:
"gzip, deflate"
,
"Accept"
:
"*/*"
,
"Connection"
:
"keep-alive"
,
"Name"
:
"john"
,
"Cookie"
:
"name=john"
}
|
4.设置timeout
通常接口都是为上游服务得，由于上游不能够长时间等待接口返回信息，都会设置一个超时时间，超过了这个时间，会将这个结果丢弃，如果我们要监控线上接口有没有超时情况，这时候我们发起请求的时候就需要设置一个超时时间,如果超过这个时间，就会抛出一个异常
|
1
|
response
=
requests.get(
"http://www.baidu.com"
,timeout
=
5
)
|
说明：
将5这个超时时间以timeout参数传入，这里得单位是秒
如果要想将连接（connect）与读取（read）都进行设置，则需要传入一个元组，第一个元素为connect超时事件，第二个元素为read超时时间
|
1
|
response
=
requests.get(
"http://www.baidu.com"
,timeout
=
(
1
,
2
))
|