Python 接口自动化 —— requests框架

1.前言

Python内置的urllib模块，也可以用于访问网络资源。但是，它用起来比较麻烦，而且，缺少很多实用的高级功能。因此我们使用 requests 模块进行进行接口测试。

requests官方文档资料地址：http://cn.python-requests.org/zh_CN/latest/

2.环境安装

cmd（win+R快捷键）输入：

 pip install requests -i https://pypi.douban.com/simple

提示以下信息表示安装成功。

3.requests发送请求

3.1 get请求无参数param

1. 将安装好的requests模块导入后，通过GET访问一个URL地址的网页页面
2. 这里的 r 也就是 response，请求后的返回值，可以调用 response 里的 status_code 方法查看状态码
3. 状态码 200 只能说明接口请求发送成功了，并不能说明功能一定是 OK 的，一般要查看响应的内容，r.text 返回文本信

1. # -*- coding:utf-8 -*-

3. # 导入 requests 模块

4. import requests

5. # 定义 url

6. url = 'http://www.cnblogs.com/wwho'

7. # 请求博客园

8. r = requests.get(url=url)

9. # 打印状态码

10. print(r.status_code)

11. # 打印文本

12. print(r.text)

3.2 get请求有参数param

url地址为：http://apis.juhe.cn/simpleWeather/query?city=深圳&key=xxx
参数：city=深圳&key=xxx

可以以字典的形式传参：
{"city": "深圳", "key": "xxx"}

多个参数格式：

 {"key1": "value1", "key2": "value2", "key3": "value3"}
 

（r.url获取当前url地址，可以检查是否传参成功）

代码：

1. # -*- coding:utf-8 -*-

3. # 导入 requests 模块

4. import requests

6. # 定义 url

7. url = 'http://apis.juhe.cn/simpleWeather/query'

8. par = {"city": "深圳",

9. "key": "4611a7abae4afe573fd7ca751d9d423a"}

11. result = requests.get(url=url, params=par)

12. # 打印文本

13. print(result.text)

3.3定制请求头

一个完整的get请求，应该包括请求行(url) 和请求头(headers)、请求参数(params)，
什么时候要加请求头呢，如果你不确定的话最好加上去。

3.4 response返回信息

response返回信息

1. -- r.status_code # 响应状态码

3. -- r.content # 字节方式的响应体，会自动为你解码 gzip 和deflate 压缩

5. -- r.headers # 以字典对象存储服务器响应头，但是这个字典比较特殊，字典键不区分大小写，若键不存在则返回 None

7. -- r.json() # Requests 中内置的 JSON 解码器，requests的方便之处还在于，对于特定类型的响应，例如JSON，可以直接获取

9. -- r.url # 获取 url

11. -- r.encoding # 编码格式，requests自动检测编码

13. -- r.cookies # 获取 cookie

15. -- r.raw # 返回原始响应体-- r.text #字符串方式的响应体，会自动根据响应头部的字符编码进行解码

17. -- r.raise_for_status() # 失败请求(非 200 响应)抛出异常

以上就是requests模块主要的返回格式。

3.5 post请求

讲post请求之前 先讲一下 requests.session()
requests.session() 获取 requests的session对象，简单来说就相当于一个微型浏览器，能自动保持登录态。所以一般对于 cookie – session 保持登录态的系统就可以使用
requests.session()

使用方法：后续的请求都使用session即可

Post请求首先要注意的就是body的数据类型

常见的有四种类型，但是不止四种：

1. 第一种：application/json： {“key1“:”value1”,“keyt2":“value2"}
2. 第二种：application/x-www-form-urlencoded：name1= value1&name2=value2
3. 第三种：multipart/form-data:这一种是表单格式的
   （文件上传，图片上传等混合式）
4. 第四种：text/xml

examples.getStateName

Body为x-www-form-urlencoded类型

怎么知道body是什么类型？

1. 接口文档有说明
2. 自己抓包看

直接通过抓包就可以看出post请求的数据类型，如下图就是x-www-form-urlencoded类型

传data参数就行（无需转json）

代码：

1. # -*- coding:utf-8 -*-

2. # @File:sms.py

3. import requests

4. host = 'http://127.0.0.1:8002'

5. session = requests.session() # 相当于微型浏览器，保持登录态

6. url = host + '/api/mgr/signin' # 定义url

7. body = {

8. "username": "byhy",

9. "password": "88888888"

10. }

11. resp = session.post(url=url, data=body)

13. status_code=resp.status_code #获取响应状态码

14. print('响应状态码:{}'.format(status_code))

16. text=resp.text # 获取响应内容，结果类型是字符串

17. print('响应内容:{}'.format(text))

19. json=resp.json() # 获取响应内容，结果是字典类型

20. print('响应内容:{}'.format(json))

22. resp_headers=resp.headers # 获取响应headers

23. print('响应header:{}'.format(resp_headers))

Body为json类型

​json=body: 这个表示自动将python里面的字典，转化为json格式参数了。关于字典和json的种种关系，后面专门写篇文章讲一下。

代码：

1. # -*- coding:utf-8 -*-

2. import requests

3. host = 'http://127.0.0.1:8002'

4. session = requests.session() # 相当于微型浏览器，保持登录态

5. url = host + '/api/mgr/signin' # 定义登录的 url

6. body = {

7. "username": "byhy",

8. "password": "88888888"

9. }

11. resp = session.post(url=url, data=body) # 发送登录请求

13. url_add_customer = host + '/api/mgr/customers' # 新建客户的 url

14. body = {

15. "action":"add_customer",

16. "data":{

17. "name":"tester",

18. "phonenumber":"13345679934",

19. "address":"深圳市南山区"

20. }

21. }

22. resp = session.post(url=url_add_customer, json=body)

23. print(resp.text) # 打印响应文本

3.6 put请求

put 请求的接口做法跟 post请求的差不多的，只是把post 请求改为 put请求。一样要看请求的格式。如果是 json 格式，也是用json接，Form格式用data接。

代码：

1. # -*- coding:utf-8 -*-

2. # @Time:2021/4/16 9:54

3. # @File:sms.py

4. import requests

5. host = 'http://127.0.0.1:8002'

6. session = requests.session() # 相当于微型浏览器，保持登录态

7. url = host + '/api/mgr/signin' # 定义登录的 url

8. body = {

9. "username": "byhy",

10. "password": "88888888"

11. }

12. resp = session.post(url=url, data=body)

14. url_modify_customer = host + '/api/mgr/customers' # 修改客户的 url

15. body = {

16. "action":"modify_customer",

17. "id": 52,

18. "newdata":{

19. "name":"深圳市桥北医院",

20. "phonenumber":"13345678888",

21. "address":"深圳市中医院"

22. }

23. }

24. resp = session.put(url=url_modify_customer, json=body)

25. print(resp.text) # 打印修改客户接口响应的文本

3.7 delete请求

delete 请求的接口做法跟 post请求的差不多的，只是把post 请求改为 delete请求。一样要看请求的格式。如果是 json 格式，也是用json接，Form格式用data接。

代码：

1. # -*- coding:utf-8 -*-

2. # @Time:2021/4/16 9:54

3. # @File:sms.py

4. import requests

5. host = 'http://127.0.0.1:8002'

6. session = requests.session() # 相当于微型浏览器，保持登录态

7. url = host + '/api/mgr/signin' # 定义登录的 url

8. body = {

9. "username": "byhy",

10. "password": "88888888"

11. }

12. resp = session.post(url=url, data=body)

14. url_delete_customer = host + '/api/mgr/customers' # 删除客户的 url

15. body = {

16. "action":"del_customer",

17. "id": 52

18. }

19. resp = session.delete(url=url_delete_customer, json=body)

20. print(resp.text) # 打印删除客户接口响应的文本

总结：

requests库的请求方法里参数众多，所以简单总结一下：

1. get请求带参数就用params=params
2. post请求是form格式就用data=data
3. post请求是json类型参数就用json=json
4. 请求头信息header就用headers=headers

 

感谢每一个认真阅读我文章的人，礼尚往来总是要有的，虽然不是什么很值钱的东西，如果你用得到的话可以直接拿走：

这些资料，对于【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴上万个测试工程师们走过最艰难的路程，希望也能帮助到你!有需要的小伙伴可以点击下方小卡片领取