当前位置： 技术文章>> Python 中如何使用 requests 库处理 API 响应？
文章标题：Python 中如何使用 requests 库处理 API 响应？
在Python中，使用`requests`库来处理API响应是一项非常基础且强大的技能。`requests`库以其简洁的API和丰富的功能，成为了Python开发者与Web服务交互的首选工具之一。下面，我将详细介绍如何在Python中使用`requests`库来发送HTTP请求、处理API响应，并展示一些高级用法，帮助你在实际项目中更加高效地利用这一库。
### 安装requests库
首先，确保你的Python环境中已经安装了`requests`库。如果未安装，可以通过pip命令轻松安装：
```bash
pip install requests
```
### 基本用法
#### 发送GET请求
GET请求通常用于从服务器检索数据。使用`requests.get()`方法发送GET请求非常简单：
```python
import requests
# 发送GET请求
url = 'https://api.example.com/data'
response = requests.get(url)
# 检查响应状态码
if response.status_code == 200:
# 读取响应内容
data = response.json() # 假设响应是JSON格式
print(data)
else:
print(f"请求失败，状态码：{response.status_code}")
```
#### 发送POST请求
POST请求通常用于向服务器提交数据。使用`requests.post()`方法时，可以通过`data`或`json`参数来发送数据：
```python
import requests
url = 'https://api.example.com/submit'
data = {'key': 'value'}
# 发送JSON数据
response = requests.post(url, json=data)
# 检查响应
if response.status_code == 200:
print("数据提交成功")
else:
print(f"提交失败，状态码：{response.status_code}")
```
### 处理响应
#### 读取响应内容
- `response.text`：以字符串形式返回响应内容。
- `response.content`：以字节形式返回响应内容，适用于二进制数据（如图片、文件等）。
- `response.json()`：如果响应是JSON格式，可以直接调用此方法解析为Python字典。
#### 响应状态码
通过`response.status_code`可以获取HTTP响应状态码，用于判断请求是否成功。常见的状态码包括200（成功）、404（未找到）、500（服务器内部错误）等。
#### 响应头
通过`response.headers`可以获取响应头信息，它是一个`CaseInsensitiveDict`对象，允许不区分大小写地访问头部字段。
```python
print(response.headers['Content-Type']) # 访问Content-Type头部
```
### 高级用法
#### 自定义请求头
在发送请求时，可以通过`headers`参数添加自定义的请求头：
```python
headers = {
'User-Agent': 'My App/1.0',
'Authorization': 'Bearer YOUR_TOKEN_HERE'
}
response = requests.get(url, headers=headers)
```
#### 超时设置
在请求过程中，可以通过`timeout`参数设置超时时间（秒），以避免请求长时间挂起：
```python
response = requests.get(url, timeout=5) # 设置超时时间为5秒
```
#### 会话对象
使用`requests.Session()`可以创建一个会话对象，它允许你在多个请求之间保持某些参数（如cookies、头部信息等）：
```python
s = requests.Session()
s.headers.update({'Authorization': 'Bearer YOUR_TOKEN_HERE'})
response = s.get(url)
```
#### 代理设置
在需要通过代理服务器发送请求时，可以通过`proxies`参数指定代理：
```python
proxies = {
'http': 'http://10.10.1.10:3128',
'https': 'http://10.10.1.10:1080',
}
response = requests.get(url, proxies=proxies)
```
### 实战案例：使用requests处理API响应
假设你正在开发一个应用，需要从一个天气预报API获取当前城市的天气信息。以下是一个使用`requests`库处理该API响应的示例：
```python
import requests
def get_weather(city):
api_url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid=YOUR_API_KEY&units=metric"
try:
response = requests.get(api_url)
if response.status_code == 200:
weather_data = response.json()
print(f"城市：{weather_data['name']}")
print(f"温度：{weather_data['main']['temp']}°C")
print(f"天气状况：{weather_data['weather'][0]['description']}")
else:
print("获取天气信息失败")
except requests.RequestException as e:
print(f"请求错误：{e}")
# 调用函数
get_weather('Beijing')
```
在这个例子中，我们首先构建了API请求的URL，其中包含了城市名、API密钥和单位（这里使用摄氏度）。然后，使用`requests.get()`发送请求，并检查响应状态码。如果请求成功，我们解析JSON响应并打印出城市的名称、温度和天气状况。如果请求失败或发生异常，我们则打印出相应的错误信息。
### 总结
`requests`库是Python中处理HTTP请求的强大工具，它提供了简洁的API和丰富的功能，使得与Web服务的交互变得简单而高效。通过本文的介绍，你应该已经掌握了如何使用`requests`库发送GET和POST请求、处理API响应以及使用其高级功能。希望这些知识能够帮助你在实际项目中更加灵活地运用`requests`库，提升你的开发效率。
最后，如果你对Python编程和Web开发感兴趣，不妨访问我的网站“码小课”，那里有更多关于Python编程、Web开发以及数据科学的精彩内容等待你去探索。在“码小课”，你可以找到从基础到进阶的各类教程和实战案例，帮助你不断提升自己的编程技能。