如何在 Python 中正确使用 API 密钥调用 REST 接口-Python教程-PHP中文网

如何在 Python 中正确使用 API 密钥调用 REST 接口

本文详解 Python 中通过 requests 库携带 API Key 访问受保护接口的正确方式，重点指出常见错误（如未传入 headers 参数、误调用 .json 方法），并提供可直接运行的完整示例与关键注意事项。

本文详解 python 中通过 `requests` 库携带 api key 访问受保护接口的正确方式，重点指出常见错误（如未传入 headers 参数、误调用 `.json` 方法），并提供可直接运行的完整示例与关键注意事项。

在调用需要身份认证的第三方 API（如 BallDontLie 的篮球数据接口）时，仅声明 headers 字典是不够的——必须显式将其作为参数传递给 requests.get()，否则请求将不包含任何认证信息，导致服务端返回 401 Unauthorized 或类似拒绝访问的状态码。

以下是最小可运行的修正代码：

Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...

下载

import requests

api_url = 'https://api.balldontlie.io/v1/teams'
api_key = 'YOUR_ACTUAL_API_KEY_HERE'  # ⚠️ 替换为你的真实密钥

headers = {
    'Authorization': api_key  # 注意：无需额外前缀（如 "Bearer"），该 API 要求纯密钥值
}

# ✅ 关键修正：必须将 headers 显式传入 requests.get()
response = requests.get(api_url, headers=headers)

print(f"HTTP 状态码: {response.status_code}")

if response.status_code == 200:
    data = response.json()  # ✅ 必须加括号调用方法，获取解析后的字典
    print("成功获取数据，前 2 支球队示例：")
    for team in data.get('data', [])[:2]:
        print(f"- {team.get('full_name', 'N/A')}")
else:
    print(f"请求失败，响应内容: {response.text}")

关键要点说明：

❌ 错误写法：requests.get(api_url) —— 此时 headers 变量完全未被使用；
✅ 正确写法：requests.get(api_url, headers=headers) —— 显式注入认证头；
.json 是一个方法对象，不是属性，因此 response.json() 才能返回 JSON 数据；若误写为 response.json，将得到类型对象，而非实际数据；
部分 API（如本例）要求 Authorization 头值为纯 API Key 字符串；而另一些 API（如多数 OAuth2 接口）则需格式如 'Bearer abc123' 或 'API-Key abc123'，务必以官方文档为准；
建议始终检查 response.status_code 并处理非 200 响应，避免静默失败；
生产环境中，请将 API Key 存于环境变量或配置文件中，切勿硬编码在源码里（例如使用 os.getenv('BALLDONTLIE_API_KEY')）。

掌握这一基础模式后，你即可安全、可靠地集成各类需密钥认证的 Web API。