17370845950

调用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：服务端出错。一般无需前端改代码，可记录日志并提示用户稍后重试。

实战中容易忽略的细节

光会发请求不够，这些点常导致调试困难：

• 始终检查 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)}