调用HTTP接口核心是理解请求方法和响应状态码；Python常用requests库，GET/POST/PUT/PATCH/DELETE对应不同操作，需关注200/201/400/401/403/404/500等状态码含义，并处理超时、异常及请求头。
调用 HTTP 接口，核心是理解 请求方法 和 响应状态码——它们决定了你“怎么发”和“服务器怎么回”。Python 中最常用的是 requests 库，简洁可靠，适合绝大多数场景。
常用 HTTP 请求方法及 Python 实现
不同请求方法对应不同的操作语义，选错可能导致接口失败或数据异常：
-
GET：获取资源（如查用户、读文章）。参数通过 URL 查询字符串传递。
示例：requests.get("https://api.example.com/users?id=123") -
POST：提交新数据（如创建用户、上传表单）。通常把数据放在请求体中，格式常用
application/json或application/x-www-form-urlencoded。
示例：requests.post(url, json={"name": "Alice", "email": "a@example.com"}) -
PUT：完整更新某资源（如全量修改用户信息），要求提供完整数据。
示例：requests.put(url, json={"id": 123, "name": "Alice", "age": 30}) -
PATCH：局部更新（如只改邮箱），更轻量、更安全。
示例：requests.patch(url, json={"email": "new@a.com"}) -
DELETE：删除指定资源。
示例：requests.delete("https://api.example.com/users/123")
关键 HTTP 状态码含义与处理建议
状态码是服务器对请求的“一句话反馈”，必须检查，不能只看 response.text：
-
200 OK：成功。但注意：200 不代表业务成功（比如返回
{"code": 40001, "msg": "token 过期"}是常见设计）。 -
201 Created：POST 成功创建资源，常用于注册、新建订单等场景，响应头中可能含
Location指向新资源地址。 - 400 Bad Request：客户端参数错误（如字段缺失、类型不对、JSON 格式错误）。应检查请求数据结构和必填项。
- 401 Unauthorized：认证失败，通常缺 token 或 token 无效。需检查 Authorization 头或登录流程是否正常。
- 403 Forbidden：权限不足（如普通用户尝试访问管理员接口）。不是登录问题，而是角色/权限配置限制。
- 404 Not Found：URL 路径错误或资源不存在。确认接口地址、ID 是否拼写正确，后端路由是否已部署。
- 500 Internal Server Error：服务端出错。一般无需前端改代码，可记录日志并提示用户稍后重试。
实战中容易忽略的细节
光会发请求不够，这些点常导致调试困难：
立即学习“Python免费学习笔记（深入）”；
- 始终检查
response.status_code，再决定是否解析 JSON；避免直接调用response.json()导致JSONDecodeError（比如 500 返回 HTML 错误页）。 - 设置超时：
requests.get(url, timeout=5)，防止请求卡死。生产环境建议设timeout=(3, 7)（连接 3 秒，读取 7 秒）。 - 带上合理的请求头，特别是
User-Agent和认证信息：headers = {"Authorization": "Bearer xxx", "Content-Type": "application/json"} - 捕获常见异常：
requests.exceptions.Timeout、requests.exceptions.ConnectionError、requests.exceptions.RequestException（基类）。
一个健壮的请求封装示例
不追求复杂，但覆盖基本健壮性：
import requests
def api_call(method, url, **kwargs):
headers = kwargs.pop("headers", {})
headers.setdefault("User-Agent", "MyApp/1.0")
try:
resp = requests.request(method, url, timeout=(3, 10), headers=headers, **kwargs)
if resp.status_code == 200:
return resp.json()
else:
print(f"HTTP {resp.status_code}: {resp.reason}")
return {"error": "http_error", "status": resp.status_code, "detail": resp.text[:200]}
except requests.exceptions.Timeout:
print("请求超时")
return {"error": "timeout"}
except requests.exceptions.ConnectionError:
print("连接失败")
return {"error": "connection_failed"}
except Exception as e:
print(f"未知错误: {e}")
return {"error": "unknown", "detail": str(e)}
