先修基础：把 API 当作一份约定

今天要弄懂什么

API 是程序之间约定好的入口。调用者按约定提交输入，服务方按约定返回结果。你不需要知道对方程序的全部内部实现，但必须理解输入与输出。

一个学校生活中的例子

假设课表服务提供查询入口，输入班级与日期，返回课程列表。JSON 对象可以表达这份结果：

{
  "class": "高一",
  "date": "2026-09-05",
  "lessons": ["数学", "英语", "AI 实验"]
}

class 与 date 是字段名；lessons 的值是数组。字段名让程序不必凭位置猜测数据含义。

一个不需要付费 API 的小练习

import json

data = {"subject": "数学", "done": False}
message = json.dumps(data, ensure_ascii=False)
print(message)
print(json.loads(message)["subject"])

先自己预测两个输出，再运行代码。把 done 改成 True，观察 Python 与 JSON 布尔值的差别。

检查自己是否理解

• 请求失败时，应该查看状态码和错误内容，而不只是重试。
• API 密钥像钥匙，应保存在服务端环境变量中。
• JSON 是数据格式，本身不会执行任务。

完成后，用自己的话写下：调用 API 与打开网页的区别是什么？