Python调用第三方API核心是构造请求、发送请求、解析响应三步，关键在认证、错误处理和数据格式；需先读文档明确URL、方法、认证方式、参数位置及响应结构。
用 Python 调用第三方 API，核心就三步：构造请求、发送请求、解析响应。关键在处理认证、错误、数据格式这些细节，下面用真实场景讲清楚。
准备：安装依赖并确认 API 文档
绝大多数 REST API 都用 requests 库调用，先装好：
pip install requests接着务必打开目标 API 的官方文档（比如 GitHub API、高德地图、聚合数据等），重点关注：
- 请求地址（URL）和请求方法（GET/POST）
- 是否需要认证（API Key、Token、Authorization 头）
- 参数传递方式（query string、JSON body、form data）
- 成功和失败时的响应结构（尤其是 status code 和 error 字段）
基础 GET 请求：带参数和认证
以「获取当前天气」为例（使用免费的 OpenWeather API）：
立即学习“Python免费学习笔记（深入）”；
# 替换为你自己的 API KeyAPI_KEY = "your_api_key_here"
CITY = "shanghai"
url = f"https://api.openweathermap.org/data/2.5/weather?q={CITY}&appid={API_KEY}&units=metric"
import requests
response = requests.get(url)
if response.status_code == 200:
data = response.json()
temp = data["main"]["temp"]
print(f"上海当前温度：{temp}°C")
else:
print("请求失败，状态码：", response.status_code)
print("错误信息：", response.text)
注意点：
- 参数直接拼在 URL 后（query string），适合 GET
- API Key 通常放 query 或 headers，看文档要求；OpenWeather 放 query 更简单
- 一定要检查 status_code，不能只靠 try-except
POST 请求：传 JSON 数据（如登录或提交表单）
假设某接口需 POST JSON 提交用户登录信息：
url = "https://api.example.com/v1/login"payload = {
"username": "testuser",
"password": "123456"
}
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer abc123xyz"
}
response = requests.post(url, json=payload, headers=headers)
if response.status_code == 200:
token = response.json().get("access_token")
print("登录成功，拿到 token：", token)
elif response.status_code == 401:
print("用户名或密码错误")
else:
print("其他错误：", response.json())
重点说明：
- 用 json= 参数自动序列化并加 Content-Type 头，比手动 dumps + headers 更安全
- 敏感操作（如登录）通常需要 Authorization header，格式按文档来（Bearer / Basic / APIKey）
- 区分 4xx（客户端错）和 5xx（服务端错），针对性处理
封装成函数：提升复用性和健壮性
实际项目中别写一堆裸 requests，封装一个通用 client：
import requestsimport time
class APIClient:
def __init__(self, base_url, api_key=None):
self.base_url = base_url.rstrip("/")
self.session = requests.Session()
if api_key:
self.session.headers.update({"X-API-Key": api_key})
def get(self, endpoint, params=None, timeout=10):
url = f"{self.base_url}/{endpoint.lstrip('/')}"
try:
resp = self.session.get(url, params=params, timeout=timeout)
resp.raise_for_status() # 自动抛出 4xx/5xx 异常
return resp.json()
except requests.exceptions.RequestException as e:
print(f"请求异常：{e}")
return None
# 使用示例
client = APIClient("https://api.example.com", api_key="xxx")
data = client.get("/users", params={"limit": 10})
这样做的好处：
- 统一管理 base_url、headers、超时、重试逻辑（可后续加）
- 自动处理常见异常，避免每次重复写 if status_code
- 方便后期加日志、鉴权刷新、请求限频等扩展
基本上就这些。不复杂但容易忽略的是：读文档、验状态码、分情况处理错误、别把密钥硬编码。跑通一次后，换别的 API 只是改 URL 和参数，套路完全一样。
