如何使用Python的requests库来调用API?

在当今的软件开发中，API（Application Programming Interface）已经成为连接不同系统、服务和应用的重要桥梁。无论是前端与后端的交互，还是微服务之间的通信，调用API都是常见的操作。Python 作为一种广泛使用的编程语言，拥有强大的库支持，其中 requests 库是进行 HTTP 请求最常用、最便捷的方式之一。

本文将围绕“如何使用 Python 的 requests 库来调用 API”展开讲解，介绍 requests 库的基本用法、常见请求方法、参数传递方式以及一些实用技巧，帮助开发者快速上手并高效地调用各类 API 接口。

一、安装 requests 库

在使用 requests 库之前，首先需要确保它已经安装在你的 Python 环境中。如果尚未安装，可以通过以下命令进行安装：

pip install requests该命令会从 Python 包索引（PyPI）下载并安装 requests 库。安装完成后，就可以在代码中导入并使用它了。

二、基本的 GET 请求

GET 请求是最常用的 HTTP 方法之一，用于从服务器获取数据。使用 requests.get() 可以轻松发送 GET 请求，并获取响应内容。

1. 示例代码：

import requests
response = requests.get('https://api.example.com/data')
print(response.status_code)  # 输出状态码
print(response.text)         # 输出响应内容

在这个例子中，我们向 https://api.example.com/data 发送了一个 GET 请求，并打印了响应的状态码和内容。

1. 注意事项：

如果 API 需要认证（如 API Key），通常会在 URL 中添加查询参数或设置请求头。

使用 response.json() 可以将 JSON 格式的响应内容转换为 Python 字典对象，方便处理。

三、发送 POST 请求

POST 请求常用于向服务器提交数据，比如注册用户、提交表单等。使用 requests.post() 方法可以实现 POST 请求。

1. 示例代码：

import requests
data = {
    'username': 'testuser',
    'password': '123456'
}
response = requests.post('https://api.example.com/login', data=data)
print(response.status_code)
print(response.json())

在这个例子中，我们向登录接口发送了用户名和密码，服务器返回了相应的结果。

1. 参数说明：

data：用于传递表单数据，适用于 application/x-www-form-urlencoded 类型。

json：用于传递 JSON 数据，适用于 application/json 类型。使用时可以直接传入字典对象。

四、设置请求头（Headers）

有些 API 要求必须携带特定的请求头信息，例如 User-Agent、Authorization 或 Content-Type。此时可以通过 headers 参数设置。

1. 示例代码：

import requests
headers = {
    'User-Agent': 'Mozilla/5.0',
    'Authorization': 'Bearer your_token_here'
}
response = requests.get('https://api.example.com/data', headers=headers)
print(response.text)

通过设置请求头，可以模拟浏览器行为或完成身份验证，提高请求的成功率。

五、处理 Cookies 和 Session

对于需要保持登录状态的 API，可以使用 Session 对象来维持会话，自动管理 cookies。

1. 示例代码：

import requests
session = requests.Session()
session.headers.update({'User-Agent': 'Mozilla/5.0'})
# 登录请求
login_data = {'username': 'user', 'password': 'pass'}
session.post('https://api.example.com/login', data=login_data)
# 后续请求自动携带 cookies
response = session.get('https://api.example.com/dashboard')
print(response.text)

使用 Session 可以避免每次请求都手动设置 cookies，提升用户体验和代码可维护性。

六、处理响应状态码和异常

在实际开发中，网络请求可能会失败，因此需要对响应状态码进行判断，并处理可能发生的异常。

1. 示例代码：

import requests
try:
    response = requests.get('https://api.example.com/data')
    response.raise_for_status()  # 如果状态码 >= 400，抛出异常
    print(response.json())
except requests.exceptions.HTTPError as err:
    print(f"HTTP error occurred: {err}")
except requests.exceptions.RequestException as err:
    print(f"An error occurred: {err}")

raise_for_status() 方法会在响应状态码为 4xx 或 5xx 时抛出异常，便于统一处理错误情况。

七、设置超时时间

为了避免程序长时间等待服务器响应，可以为请求设置超时时间，防止阻塞。

1. 示例代码：

import requests
response = requests.get('https://api.example.com/data', timeout=5)
print(response.text)

这里的 timeout=5 表示如果超过 5 秒没有收到响应，将抛出 Timeout 异常。

八、上传文件和下载文件

requests 还支持文件的上传和下载功能，适用于需要处理文件的场景。

1. 上传文件示例：

import requests
files = {'file': open('example.txt', 'rb')}
response = requests.post('https://api.example.com/upload', files=files)
print(response.text)下载文件示例：
import requests
response = requests.get('https://example.com/file.txt')
with open('downloaded_file.txt', 'wb') as f:
    f.write(response.content)

通过这些方法，可以轻松实现文件的上传与下载操作。

Python 的 requests 库是一个强大而易用的 HTTP 客户端工具，能够帮助开发者快速构建与 API 的交互逻辑。从基础的 GET 和 POST 请求，到设置请求头、处理 cookies、上传下载文件，再到异常处理和超时控制，requests 提供了全面的功能支持。

声明：所有来源为“聚合数据”的内容信息，未经本网许可，不得转载！如对内容有异议或投诉，请与我们联系。邮箱：marketing@think-land.com