Web API 基础：让程序与外部系统协作

你现在可能会困惑什么

“请求成功 200 就算完成了吗？”

不一定。还要校验响应体字段和业务状态。

一句话定义

API 是系统间的数据契约，按方法和参数交换请求/响应。

生活类比

点餐窗口：按菜单格式下单，按约定返回结果。

最小可运行例子

import requests
resp = requests.get("https://jsonplaceholder.typicode.com/posts/1", timeout=10)
print(resp.status_code)
print(resp.json())

课堂小测（5 分钟）

1. 调用用户列表 API。
2. 提取 id/name/email。
3. 保存到本地 JSON。

课堂小测参考答案与判分点

• 参考答案方向：能写出可运行代码，并覆盖题目中的核心条件与边界输入。
• 判分点 1（正确性）：主流程结果正确，关键分支可执行。
• 判分点 2（可读性）：变量命名清晰，结构不过度嵌套。
• 判分点 3（健壮性）：对空值、类型错误或异常输入有基础保护。

迁移任务（课后）

封装 fetch_json(url)，统一异常处理与返回结构。

本节验收标准

你能独立做到：

• 发起 GET/POST 请求
• 处理状态码与异常
• 校验关键响应字段

常见报错与调试步骤（新手版）

• 报错看不懂：先读最后一行错误类型（如 TypeError、NameError），再回到对应代码行定位。
• 不确定变量值：在关键位置临时 print(变量, type(变量))，先确认数据是否符合预期。
• 改了代码却没生效：确认文件已保存、运行的是当前文件、终端环境（venv）是否正确。

常见误区

• 误区：不设 timeout。
• 正解：生产代码必须设超时。