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

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

本文详解如何在 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)

⚠️ 关键注意事项：

Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。

下载

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()。