Python requests
库详细介绍
requests
是一个用于发送 HTTP 请求的 Python 库。它简化了 HTTP 请求的过程,并提供了简洁易用的 API。requests
库广泛应用于 Web 开发、数据抓取、API 调用等场景。
1. 安装
在使用 requests
库之前,需要先安装它。可以通过 pip
来安装:
pip install requests
2. 主要功能
requests
库提供了以下主要功能:
- 发送 HTTP 请求:支持 GET、POST、PUT、DELETE 等常见 HTTP 方法。
- 处理响应:获取响应的状态码、响应头、响应内容等。
- 传递参数:支持在 URL 中传递查询参数,或在请求体中传递表单数据、JSON 数据等。
- 处理会话:通过会话对象保持 cookies 和认证信息。
- 处理文件上传:支持上传文件。
- 处理异常:捕获和处理网络请求中的异常。
3. 常用方法
以下是 requests
库中常用的方法及其使用案例:
3.1 requests.get()
get()
方法用于发送 GET 请求。
案例:
import requests
# 发送 GET 请求
response = requests.get('https://jsonplaceholder.typicode.com/posts')
# 打印响应状态码
print(response.status_code)
# 打印响应内容(JSON 格式)
print(response.json())
解释:
response.status_code
:获取响应的状态码。response.json()
:将响应内容解析为 JSON 格式。
3.2 requests.post()
post()
方法用于发送 POST 请求。
案例:
import requests
# 发送 POST 请求
data = {'title': 'foo', 'body': 'bar', 'userId': 1}
response = requests.post('https://jsonplaceholder.typicode.com/posts', json=data)
# 打印响应状态码
print(response.status_code)
# 打印响应内容(JSON 格式)
print(response.json())
解释:
json=data
:将 Python 字典数据转换为 JSON 格式,并作为请求体发送。
3.3 requests.put()
put()
方法用于发送 PUT 请求。
案例:
import requests
# 发送 PUT 请求
data = {'title': 'foo', 'body': 'bar', 'userId': 1}
response = requests.put('https://jsonplaceholder.typicode.com/posts/1', json=data)
# 打印响应状态码
print(response.status_code)
# 打印响应内容(JSON 格式)
print(response.json())
解释:
put()
方法用于更新资源。
3.4 requests.delete()
delete()
方法用于发送 DELETE 请求。
案例:
import requests
# 发送 DELETE 请求
response = requests.delete('https://jsonplaceholder.typicode.com/posts/1')
# 打印响应状态码
print(response.status_code)
解释:
delete()
方法用于删除资源。
3.5 requests.patch()
patch()
方法用于发送 PATCH 请求。
案例:
import requests
# 发送 PATCH 请求
data = {'title': 'foo'}
response = requests.patch('https://jsonplaceholder.typicode.com/posts/1', json=data)
# 打印响应状态码
print(response.status_code)
# 打印响应内容(JSON 格式)
print(response.json())
解释:
patch()
方法用于部分更新资源。
3.6 requests.head()
head()
方法用于发送 HEAD 请求。
案例:
import requests
# 发送 HEAD 请求
response = requests.head('https://jsonplaceholder.typicode.com/posts')
# 打印响应头
print(response.headers)
解释:
head()
方法用于获取资源的头部信息,而不包含响应体。
3.7 requests.options()
options()
方法用于发送 OPTIONS 请求。
案例:
import requests
# 发送 OPTIONS 请求
response = requests.options('https://jsonplaceholder.typicode.com/posts')
# 打印响应头
print(response.headers)
解释:
options()
方法用于获取资源的允许操作(如允许的 HTTP 方法)。
4. 处理查询参数
可以在 URL 中传递查询参数,使用 params
参数。
案例:
import requests
# 发送带有查询参数的 GET 请求
params = {'userId': 1}
response = requests.get('https://jsonplaceholder.typicode.com/posts', params=params)
# 打印响应内容(JSON 格式)
print(response.json())
解释:
params=params
:将查询参数附加到 URL 中。
5. 处理请求头
可以通过 headers
参数自定义请求头。
案例:
import requests
# 发送带有自定义请求头的 GET 请求
headers = {'User-Agent': 'Mozilla/5.0'}
response = requests.get('https://jsonplaceholder.typicode.com/posts', headers=headers)
# 打印响应内容(JSON 格式)
print(response.json())
解释:
headers=headers
:自定义请求头。
6. 处理会话
可以通过 requests.Session()
创建会话对象,保持 cookies 和认证信息。
案例:
import requests
# 创建会话对象
session = requests.Session()
# 发送 GET 请求
response = session.get('https://jsonplaceholder.typicode.com/posts')
# 打印响应状态码
print(response.status_code)
解释:
Session()
:创建会话对象,保持会话状态。
7. 处理文件上传
可以使用 files
参数上传文件。
案例:
import requests
# 发送带有文件上传的 POST 请求
files = {'file': open('example.txt', 'rb')}
response = requests.post('https://httpbin.org/post', files=files)
# 打印响应内容(JSON 格式)
print(response.json())
解释:
files=files
:上传文件。
8. 处理异常
可以通过 try-except
捕获和处理网络请求中的异常。
案例:
import requests
try:
response = requests.get('https://jsonplaceholder.typicode.com/nonexistent')
response.raise_for_status() # 检查响应状态码,如果不是 200-299,抛出异常
except requests.exceptions.HTTPError as err:
print(f"HTTP 错误: {err}")
except requests.exceptions.RequestException as err:
print(f"请求异常: {err}")
解释:
response.raise_for_status()
:检查响应状态码,如果不是 200-299,抛出异常。
9. 其他常用方法
response.text
:获取响应内容,返回字符串。response.content
:获取响应内容,返回字节流。response.headers
:获取响应头。
案例:
import requests
response = requests.get('https://jsonplaceholder.typicode.com/posts')
# 打印响应内容(字符串)
print(response.text)
# 打印响应内容(字节流)
print(response.content)
# 打印响应头
print(response.headers)
10. 总结
requests
库是一个功能强大且易于使用的 HTTP 请求库。它简化了 HTTP 请求的过程,提供了丰富的 API 来处理各种场景。通过 requests
库,可以轻松地发送 GET、POST、PUT、DELETE 等请求,处理响应,传递参数,上传文件,处理异常等。
希望这份详细的介绍对你整理笔记有所帮助!如果你有其他问题,欢迎继续提问。