使用 Python 的 `requests` 库调用 API 接口是一种高效且常见的开发方式，适用于各种网络请求场景。以下是详细的使用方法和常见场景示例，帮助你快速上手。 ### 发送 GET 请求 GET 请求通常用于获取数据。以下是一个简单的 GET 请求示例： ```python import requests response = requests.get('https://api.example.com/data') print(response.status_code) # 输出状态码 print(response.json()) # 输出返回的 JSON 数据 ``` GET 请求也可以携带参数，参数可以以字典形式传递： ```python params = {'key1': 'value1', 'key2': 'value2'} response = requests.get('https://api.example.com/data', params=params) ``` ### 发送 POST 请求 POST 请求通常用于提交数据。以下是一个基本的 POST 请求示例： ```python data = {'key1': 'value1', 'key2': 'value2'} response = requests.post('https://api.example.com/submit', data=data) ``` 如果需要发送 JSON 数据，可以使用 `json` 参数： ```python json_data = {'name': 'Test repo', 'description': 'Some test repository'} response = requests.post('https://api.example.com/submit', json=json_data) ``` ### 处理请求头 某些 API 接口需要特定的请求头信息，例如认证信息或内容类型。可以通过 `headers` 参数传递请求头： ```python headers = {'Authorization': 'Bearer YOUR_TOKEN', 'Content-Type': 'application/json'} response = requests.get('https://api.example.com/data', headers=headers) ``` ### 处理响应 `requests` 库提供了多种方法来处理响应数据。例如，可以通过 `response.text` 获取文本内容，通过 `response.json()` 解析 JSON 数据，或者通过 `response.status_code` 获取状态码。 ```python if response.status_code == 200: print("请求成功") print(response.json()) else: print("请求失败，状态码：", response.status_code) ``` ### 异常处理 在实际开发中，网络请求可能会遇到各种异常，例如连接失败或超时。可以通过 `try-except` 块来捕获并处理这些异常： ```python try: response = requests.get('https://api.example.com/data', timeout=5) response.raise_for_status() # 如果响应状态码不是 200，抛出异常 except requests.exceptions.RequestException as e: print("请求过程中发生错误：", e) ``` ### 使用会话对象 如果需要发送多个请求，并且希望保持某些参数（例如请求头），可以使用 `Session` 对象： ```python with requests.Session() as session: session.headers.update({'Authorization': 'Bearer YOUR_TOKEN'}) response1 = session.get('https://api.example.com/data1') response2 = session.post('https://api.example.com/submit', json={'key': 'value'}) ``` ### 文件上传 如果需要上传文件，可以使用 `files` 参数： ```python files = {'file': open('example.txt', 'rb')} response = requests.post('https://api.example.com/upload', files=files) ``` ### 认证 某些 API 接口需要认证，例如 Basic Auth 或 OAuth。可以使用 `auth` 参数传递认证信息： ```python from requests.auth import HTTPBasicAuth response = requests.get('https://api.example.com/data', auth=HTTPBasicAuth('username', 'password')) ``` ### 总结 `requests` 库提供了丰富的功能来简化 HTTP 请求的处理流程，包括 GET、POST 请求、请求头设置、响应处理、异常捕获、文件上传和认证等[^1]。通过这些功能，可以高效地调用 API 接口并处理返回的数据。 ---