推荐封装统一的 request_api() 函数，支持方法、头、参数、超时等收口管理，自动解析 json 并分类处理网络异常、http 错误及业务错误，提升可维护性与复用性。
用 requests 封装通用请求方法
直接在每个接口调用处写 requests.get() 或 requests.post() 容易重复、难维护。推荐封装一个统一的 request_api() 函数，把 URL、method、headers、params、json、timeout 等常用参数收口管理。
关键点：默认加常用 headers（如 User-Agent、Content-Type），支持传入自定义 headers 覆盖；自动处理 JSON 响应解析；异常统一捕获并返回结构化错误信息。
支持鉴权与会话保持的封装
很多接口需要 token、cookie 或 Basic Auth。可在封装函数中预留 auth、cookies、token 参数，或通过类方式管理会话状态。
- 用
requests.Session()复用连接、自动携带 cookie，适合登录后连续调用 - token 放在 headers 中：
{"Authorization": f"Bearer {token}"} - 敏感凭据不硬编码，建议从环境变量或配置文件读取（如
os.getenv("API_TOKEN")）
响应统一处理与错误分类
不是所有 HTTP 200 都代表业务成功。常见做法是约定响应体含 "code": 0 表示成功，否则为业务错误；网络超时、连接失败则属于请求层异常。
立即学习“Python免费学习笔记（深入）”；
- 检查
response.status_code，非 2xx 主动抛出HTTPError - 解析 JSON 后再校验
data.get("code") == 0，否则包装成BusinessError - 对
requests.Timeout、requests.ConnectionError单独捕获并重试（可配合tenacity库）
简单可复用的封装示例
以下是一个轻量但实用的封装函数，支持 GET/POST、自动 JSON 解析、基础错误处理：
import requests
import json
<p>def request_api(url, method="GET", headers=None, params=None, json_data=None, timeout=10):
default_headers = {"User-Agent": "Python-Requests", "Content-Type": "application/json"}
if headers:
default_headers.update(headers)</p><pre class='brush:python;toolbar:false;'>try:
resp = requests.request(
method=method.upper(),
url=url,
headers=default_headers,
params=params,
json=json_data,
timeout=timeout
)
resp.raise_for_status() # 抛出 4xx/5xx 异常
return resp.json() # 默认按 JSON 解析
except requests.exceptions.Timeout:
return {"error": "request_timeout", "message": "请求超时"}
except requests.exceptions.ConnectionError:
return {"error": "connection_failed", "message": "连接失败"}
except requests.exceptions.HTTPError as e:
return {"error": "http_error", "message": f"HTTP {resp.status_code}", "raw": resp.text}
except json.JSONDecodeError:
return {"error": "invalid_json", "message": "响应非 JSON 格式", "raw": resp.text}调用时只需一行：data = request_api("https://api.example.com/user", params={"id": 123})，无需每次处理异常和解析。
