Python调用HTTP REST接口核心是requests库：GET用params/headers/timeout；POST按JSON/form/file选json/data/files参数；认证支持Bearer、API Key、Basic；用Session管理会话与连接复用。
用 Python 调用 HTTP REST 接口，核心是掌握 requests 库的常用方法和关键细节。它比原生 urllib 更简洁，也比 Flask/FastAPI 的服务端逻辑更贴近日常开发中的客户端调用场景。
基础 GET 请求：带参数和 Headers
大多数公开 API（如 GitHub、天气接口）都支持 GET。注意 URL 参数、请求头、超时设置这三点：
- 用
params=传查询参数，requests 会自动编码（比如空格变 %20） - 通过
headers=设置 User-Agent 或认证 token，避免被服务器拒绝 - 务必加
timeout=（建议 5–10 秒），防止请求卡死影响主流程
示例：
import requests
<p>url = "<a href="https://www.php.cn/link/de4ae1f4f810873e3b18b2f942b45795">https://www.php.cn/link/de4ae1f4f810873e3b18b2f942b45795</a>"
params = {"per_page": 5}
headers = {"User-Agent": "MyApp/1.0"}
try:
resp = requests.get(url, params=params, headers=headers, timeout=5)
resp.raise_for_status() # 抛出 4xx/5xx 错误
data = resp.json()
print(data[0]["login"])
except requests.exceptions.RequestException as e:
print("请求失败：", e)
POST 提交数据：表单、JSON、文件上传
POST 是最常用来写入或触发操作的请求方式，不同内容类型对应不同传参方式：
立即学习“Python免费学习笔记（深入）”；
- 提交 JSON 数据：用
json=参数，requests 自动设 Content-Type 为 application/json，并序列化 - 发送表单（如登录）：用
data=，传字典，Content-Type 默认为 application/x-www-form-urlencoded - 上传文件：用
files=，传{"file": open("a.jpg", "rb")}，requests 自动构造 multipart/form-data
注意：不要混用 json= 和 data=；上传文件后不能同时用 json=。
处理认证与状态码
很多 REST 接口需要身份验证，常见方式有三种：
- Bearer Token：在 headers 中加
"Authorization": "Bearer xxx" - API Key：通常放在 headers（如
"X-API-Key": "abc123"）或作为 query 参数 - Basic Auth：用
auth=(user, pwd)，requests 自动编码并放入 Authorization 头
收到响应后，先检查 resp.status_code 是否为 200/201，再调用 resp.json()。非 2xx 响应默认不报错，要用 raise_for_status() 主动捕获。
会话管理与复用连接
如果要连续调用多个接口（比如先登录再获取数据），推荐用 requests.Session()：
- 自动保持 Cookie，适合登录态维持
- 底层复用 TCP 连接，提升多次请求性能
- 可统一设置 headers、timeout、auth，避免重复传参
示例：
s = requests.Session()
s.headers.update({"User-Agent": "MyApp/1.0"})
s.auth = ("user", "pass")
s.timeout = 5
<h1>登录（返回 session cookie）</h1><p>s.post("<a href="https://www.php.cn/link/052c3ffc93bd3a4d5fc379bf96fabea8">https://www.php.cn/link/052c3ffc93bd3a4d5fc379bf96fabea8</a>", data={"u": "a", "p": "b"})</p><h1>后续请求自动携带 cookie</h1><p>resp = s.get("<a href="https://www.php.cn/link/3bddd1aafe78ece8cf3ed90b61d847d8">https://www.php.cn/link/3bddd1aafe78ece8cf3ed90b61d847d8</a>")
