本文详解如何在 Python 中通过 requests 库携带 API 密钥（Authorization Header）安全、准确地调用 REST API，重点纠正常见错误：未将 headers 传入请求方法、误用 response.json 属性而非方法等。
本文详解如何在 python 中通过 `requests` 库携带 api 密钥（authorization header）安全、准确地调用 rest api，重点纠正常见错误：未将 headers 传入请求方法、误用 `response.json` 属性而非方法等。
在 Python 中调用受密钥保护的 API 时，仅定义 headers 字典是不够的——你必须显式将其作为参数传递给 requests.get()（或其它 HTTP 方法）。否则，requests 完全不会感知该头部信息，导致服务器因缺少认证而返回 401 Unauthorized 或 403 Forbidden 等拒绝访问状态码。
以下是修正后的完整示例（以 BallDontLie API 为例）：
import requests
api_url = 'https://api.balldontlie.io/v1/teams'
api_key = 'your_actual_api_key_here' # ✅ 替换为你的真实密钥（切勿硬编码于生产代码中）
headers = {
'Authorization': api_key # ✅ 正确设置 Authorization 头（无需前缀如 "Bearer"，依文档而定）
}
# ✅ 关键修正：将 headers 显式传入 requests.get()
response = requests.get(api_url, headers=headers)
print(f"HTTP 状态码: {response.status_code}")
if response.status_code == 200:
data = response.json() # ✅ 注意：是 .json() 方法调用，不是 .json 属性
print("成功获取数据:", data.get('data', [])[:3]) # 示例：打印前3个球队
else:
print(f"请求失败，错误码: {response.status_code}")
print("响应内容:", response.text)⚠️ 关键注意事项：
- Headers 必须传参：requests.get(url, headers=headers) 是强制步骤，Python 不会自动注入局部变量；
- .json() 是方法，不是属性：response.json 返回一个可调用对象，只有加 () 才真正解析 JSON 响应体；
- 密钥安全：开发阶段可临时写入变量，但上线前务必使用环境变量（如 os.getenv('API_KEY')）或配置管理工具，严禁提交密钥到代码仓库；
-
检查文档认证格式：部分 API 要求 Authorization: Bearer
或 Authorization: Token ，请严格遵循其文档说明（本例为纯密钥直传）； - 添加异常处理更健壮：实际项目中建议包裹 try/except requests.RequestException，并校验 response.raise_for_status()。
掌握这一基础模式后，你即可复用于绝大多数基于 Header 认证的 Web API，为构建数据集成、自动化脚本和后端服务打下坚实基础。
立即学习“Python免费学习笔记（深入）”；
