requests模块是一个很实用的Python HTTP客户端库,爬虫和测试服务器响应数据时经常会用到,它是python语言的第三方的库,专门用于发送HTTP请求,使用起来比urllib更简洁也更强大。
使用以下的命令安装request模块
pip install requests
我们可以使用以下语句,导入requests模块
import requests
requests模块常用的方法如下表:
序号 | 方法 | 描述 |
---|---|---|
1 | requests.request(url) | 构造一个请求,支持以下各种方法 |
2 | requests.get() | 发送一个Get请求 |
3 | requests.post() | 发送一个Post请求 |
4 | requests.head() | 获取HTML的头部信息 |
5 | requests.put() | 发送Put请求 |
6 | requests.patch() | 提交局部修改的请求 |
7 | requests.delete() | 提交删除请求 |
其中最常用的方法为get()和post(),分别用于发送Get请求和Post请求
requests模块常用的属性如下表:
序号 | 属性或方法 | 描述 |
---|---|---|
1 | response.status_code | 响应状态码 |
2 | response.content | 把response对象转换为二进制数据 |
3 | response.text | 把response对象转换为字符串数据 |
4 | response.encoding | 定义response对象的编码 |
5 | response.cookie | 获取请求后的cookie |
6 | response.url | 获取请求网址 |
7 | response.json() | 内置的JSON解码器 |
8 | Response.headers | 以字典对象存储服务器响应头,字典键不区分大小写 |
比如我们想要向某个网站发送一个请求:
#使用requests库前都要导入requests库
import requests
#发送GET,POST,PUT,DELETE,HEAD 以及 OPTIONS 请求
r = requests.get('https://www.baidu.com')
r = requests.post('https://www.baidu.com')
r = requests.put('https://www.baidu.com')
r = requests.delete('https://www.baidu.com')
r = requests.head('https://www.baidu.com')
当请求返回后,我们如何查看响应对象的内容
import requests
respone = requests.get("http://www.baidu.com")
# 查看响应状态码
respone.status_code
# 查看响应头
respone.headers
# 查看响应体,未进行解码
respone.content
# 查看响应体,解码之后的
respone.text
# 查看当前的 encoding
respone.encoding
实列代码输出如下:
手动将 json 格式的响应体转换为字典
import json
import requests
# 这里请求 postman 提供的地址,他会返回一个 json 格式的响应体
url = 'https://postman-echo.com/ip'
resp = requests.get(url)
# 获取响应头
headers = resp.headers
# 获取响应头 Content-Type ;这个头告诉客户端响应体的格式
content_type = headers.get('Content-Type','no [Content-Type] header')
# 判断是否是 json 格式的响应体
if 'application/json' in content_type:
# 获取响应体
content = resp.content
# 通过 json.loads 解析为字典
dict_data = json.loads(content)
# 查看 dict_data
print(type(dict_data))
else:
print(f'响应体格式是:{content_type} ,不是 json 格式的')
通过 响应对象的 json 方法
import requests
# 这里请求 postman 提供的地址,他会返回一个 json 格式的响应体
url = 'https://postman-echo.com/ip'
resp = requests.get(url)
# 通过响应对象的 json 方法获取 json 数据
print(resp.json())
# {'ip': '140.206.149.83'}
如果 JSON 解码失败, r.json() 就会抛出一个异常。例如,响应内容是 html 格式的,尝试访问 r.json() 将会抛出异常。
import requests
# 这里请求百度首页
url = 'http://www.baidu.com'
# 请求 baidu 的首页,这里会获得 html
resp = requests.get(url)
# 响应体不是 json 类型,会抛出异常
print(resp.json())
# 抛出异常
# ......
# JSONDecodeError: Expecting value: line 1 column 1 (char 0)
import requests
# 这个接口会把我们传递的 url 参数,通过响应体返回
url = 'https://postman-echo.com/get'
# GET请求时传递参数
payload = {'key1': 'value1', 'key2': 'value2', 'key3': ['value3', 'valua4']}
# 通过 params 参数传递 url 参数
resp = requests.get(url, params=payload)
# 查看发起请求的的完整 url
print(resp.url)
# 查看响应体
print(resp.json())
# 手动拼接参数
url = 'https://postman-echo.com/get?key1=value1&key2=value2&key3=value3&key3=value4'
resp = requests.get(url)
# 查看响应体 json
print(resp.json())
import requests
# 这个接口会把我们携带的请求头通过响应体返回
url = 'https://postman-echo.com/headers'
# 定义请求头字典
headers = {'test-header': 'my-accept'}
# 通过 headers 参数传递自定义请求头
resp = requests.get(url, headers=headers)
# 查看响应体 json
print(resp.json())
注意: 所有的 header 值必须是 string、bytestring 或者 unicode。尽管传递 unicode header 也是允许的,但不建议这样做
快速访问响应的cookie
import requests
# 访问这个接口时,服务器会返回一个 cookie
url = 'https://postman-echo.com/cookies'
resp = requests.get(url)
# 通过响应对象的 cookies 属性查看服务器返回的 cookie
print(resp.cookies)
# ]
从 http 协议的角度来说,服务返回的 cookie 是通过响应头的 set-cookie 返回的,requests 包会自动解析 set-cookie 响应头,将解析的 cookies 放到响应对象的 cookies 属性中,所以我们也可以通过 resp.headers 查看 cookie 的响应头。
发送cookies到服务器
import requests
# 这个接口会把我们携带的cookies通过响应体返回
url = 'https://postman-echo.com/cookies'
# 构建 cookie
cookies = {
'foo1':'foo1',
'foo2':'foo2'
}
# 通过 cookies 参数发送 cookies
resp = requests.get(url, cookies=cookies)
# 查看响应体 json
print(resp.json())
把 Cookie Jar 传到 Requests 中:
import requests
# 新建 RequestsCookieJar 对象
jar = requests.cookies.RequestsCookieJar()
# 通过 set 方法添加 cookie
jar.set('foo1', 'f001')
jar.set('foo2', 'f0002')
# 这个接口会把我们携带的cookies通过响应体返回
url = 'https://postman-echo.com/cookies'
# 通过 cookies 参数传递 cookiejar 对象
resp = requests.get(url, cookies=jar)
# 查看响应体 json
print(resp.json())
除了 get 请求方法之外,我们常用的还有 post 方法,使用 requests可以方便的发送 json 数据给服务器。我们把 python 的字典传递给 post 方法的 json 参数即可。
import requests
auth = {
"username":"admin",
"password":"admin1234"
}
# 调用登录接口
url = 'http://localhost:8000/login/'
# 将 auth 传递给 json
resp = requests.post(url, json=auth)
# 查看响应体 json
print(resp.json())
我们通过浏览器进行登录操作时,服务器会返回cookie,浏览器会把这些 cookie 存储下来,下次发起请求就把之前保存的 cookie 携带着发送给服务器,从而实现了状态保持。
我们通过 requests.[get|post|…] 进行登录操作或者其他操作,服务器返回了 cookie,下次再通过 requests.[get|post|…] 发起其他请求时,requests 并不会把前面请求的 cookie 携带着发送给服务器,也就是说我们通过 requests.[get|post|…] 是无法自动实现状态保持的。
我们可以通过 requests.Session 来实现状态保持,我们通过 Session 对象的 [get|post|…] 方法发起请求,session 对象会自动保存响应的 cookie,并且下次发起请求时自动携带着这些 cookie。session.cookies 可以查看 session 中保存的所有 cookie。
需求:获取用户信息。获取用户信息必须先调用进行用户登录接口,在调用获取用户信息接口。
requests 方式
from requests import Request
auth = {
"username":"admin",
"password":"admin1234"
}
# 调用登录接口
login_url = 'http://localhost:8000/login/'
# 将 auth 传递给 json
resp = requests.post(login_url, json=auth)
print(resp.json())
# 调用用户信息接口
info_url = 'http://localhost:8000/info/'
resp = requests.get(info_url)
print(resp.json())
session 方式
from requests import Request, Session
# 新建 session 对象
session = Session()
# 查看 session 中的 cookie
print(session.cookies)
auth = {
"username":"admin",
"password":"admin1234"
}
# 调用登录接口
login_url = 'http://localhost:8000/login/'
# 通过 session 发起请求
resp = session.post(login_url, json=auth)
# 通过 resp.cookies 查看
print(session.cookies)
print(resp.json())
# 调用用户信息接口
info_url = 'http://localhost:8000/info/'
resp = session.get(info_url)
print(resp.json())
session.cookies 对象类似于字典,我们可以通过操作字典的方式操作 cookies
from requests import Session
session = Session()
print(session.cookies)
# 添加 cookie
session.cookies['cookie-1']='value-1'
print(session.cookies)
# 修改 cookie
session.cookies['cookie-1']='value-1-updated'
print(session.cookies)
# 查看 cookie
print(session.cookies['cookie-1'])
print(session.cookies.get('cookie-1'))
# 删除
del session.cookies['cookie-1']
print(session.cookies)
使用 cookie 的状态保持本身有一些缺陷,因为浏览器发起请求时会自动携带 cookie,攻击者利用这一点进行跨域攻击 CSRF。为了避免这种情况发生,有一种解决方案是: 将认证信息添加到自定义的请求头中,由于是自定义的请求头,浏览器也就无法自动携带该请求头,我们需要在发起 ajax 请求的时候,手动添加该请求头。
在 session 中我们可以通过把 自定义的请求头 放入 session.headers 中,那么每次通过 session 对象发起请求的时候,就会自动携带者该请求头,不用每次都通过 headers 参数来携带。
session.headers 和 cookies 类似,也是字典格式的对象。
from requests import Session
# 这个接口会把我们携带的请求头通过响应体返回
url = 'https://postman-echo.com/headers'
# 新建 session 对象
session = Session()
# 打印 session.headers 的默认值
print(session.headers)
# 添加自定义请求头
session.headers['Auth-Token'] = 'some token xxxxx'
resp = session.get(url)
# 查看响应体 json
print(resp.json())
# 如果添加了 headers 参数,那么会和 session.headers 合并
resp = session.get(url,headers={'my-header':'header-value'})
print(resp.json())
# headers 参数不会被保存到 session.headers 中,只对当请求有效
print(session.headers)