API调用核心是看清文档、构造请求、处理响应;需关注URL、方法、Headers和参数位置,用requests发请求并检查状态,响应优先用.json()解析,异常要分层捕获。

调用API接口,核心就三点:看清文档、构造请求、处理响应。别被术语吓住,其实和浏览器访问网页逻辑一样——你发个请求,对方回个数据。
看懂API文档是前提
很多新手卡在第一步,不是代码写错,而是没读懂文档。重点关注四个地方:
- 请求地址(URL):注意是GET还是POST,路径有没有版本号(比如/api/v2/users)
- 请求方法(Method):GET查数据、POST提数据、PUT改全量、DELETE删资源,别混用
- 请求头(Headers):常见要带Authorization: Bearer xxx或Content-Type: application/json
- 参数位置:URL里的是query参数(如?page=1&limit=10),Body里的是data或json参数,别塞错地方
用requests发请求最省心
Python生态里,requests库是调用API的事实标准。装好就能用:
pip install requests
立即学习“Python免费学习笔记(深入)”;
基础写法就三行:
- GET请求带参数:requests.get(url, params={'page': 1}, headers=headers)
- POST提交JSON:requests.post(url, json={'name': '张三'}, headers=headers)
- POST提交表单:requests.post(url, data={'email': 'a@b.com'}, headers=headers)
记得加timeout=10,避免卡死;用response.raise_for_status()自动检查HTTP错误码。
解析响应别硬拆字符串
收到的响应不是文本,是Response对象。别用.text再手动split或正则——99%情况它返回的是JSON:
- 先确认response.headers.get('content-type')含application/json
- 直接用response.json()转成Python字典,安全又方便
- 如果报JSONDecodeError,说明接口返回了HTML错误页或空内容,先打印response.text看看真实返回啥
异常处理要覆盖常见场景
网络不稳、token过期、参数错误……这些都会让调用失败。建议至少包三层:
- requests.exceptions.Timeout:超时单独捕获,可重试
- requests.exceptions.ConnectionError:网络不通,提示检查代理或网址
- response.raise_for_status()抛出的HTTP异常:比如401要刷新token,400要检查传参
别让一个接口挂掉整个程序,用try-except兜底,再加点日志输出,调试时能省半小时。
基本上就这些。不复杂,但容易忽略细节。把文档当说明书读,把requests当遥控器用,把response.json()当默认操作——API调用就稳了一大半。










