第 13 课 简单 API 的理解
所属课程
青少年高级营
所属模块
模块 B：数据库与接口入门
本课概览
- 讲解核心：页面和数据之间通过什么方式沟通。
- 本课重点：页面和数据之间通过什么方式沟通。
- 课上产出：API 调用流程图。
- 示例场景：页面和系统之间的一次请求与返回
本课知识图谱
- 接口可以理解成“页面把需求说出去，系统把结果带回来”的通道。
- 请求里要说清要什么，返回里要看懂得到什么。
- API 先理解成流程关系，比先背术语更重要。
- 本课重点要落在“页面和数据之间通过什么方式沟通。”上。
课前准备
老师准备
- 提前准备与“页面和系统之间的一次请求与返回”相关的课堂示例页或草图，方便学生先看见成品轮廓。
- 准备一张“请求发出与结果返回的流程图截图”作为课堂演示图。
- 准备一张“页面按钮、接口动作和返回内容三栏对照图”作为课堂演示图。
- 把本课阶段成果“API 调用流程图。”的评价标准提前写在板书或投屏页上。
学生准备
- 准备好本节课会用到的文字、图片或题目素材。
- 带着“简单 API 的理解”相关的一个真实使用场景进入课堂，方便快速进入任务。
- 准备在课堂上记录一张草图、流程图或问题清单。
本课素材清单
- 一次“查询活动列表”或“提交作业”的流程卡
- 请求与返回示意图
- 接口说明小卡：我要什么、我收到什么
- 阶段成果模板：API 调用流程图。
- 参考来源：appendix/4-server-and-backend/api-intro.md
可直接使用的素材正文
示例文本
text
接口动作示例
页面动作：点击“查询活动列表”
系统动作：把活动数据找出来
结果：页面展示 3 条活动卡片
课堂示例：点击“查看社团活动”后，页面显示“春季运动会”“英语配音比赛”“创客社公开体验课”。示例数据 / 字段
text
请求示意：
- 想拿到：活动名称、时间、地点
返回示意：
- 春季运动会 / 周五下午 / 操场
- 英语配音比赛 / 周三中午 / 报告厅练习题 / 操作任务
text
练习 1：把“查询活动列表”换成“查询图书借阅记录”，重写一遍流程。
练习 2：列出 3 个页面想拿到的字段，例如活动名称、时间、地点。
练习 3：写一句话解释“页面发出请求，系统处理，结果再回到页面”。成套素材包
text
接口流程示例素材
页面动作：点击“查看社团活动”。
系统处理：查询活动名称、时间、地点和报名状态。
页面结果：显示“春季运动会 / 周五下午 / 操场 / 报名中”“英语配音比赛 / 周三中午 / 报告厅 / 即将截止”。
老师讲解句：页面先提出需要的数据，系统处理后再把结果送回来。课堂练习题组
text
1. 把“查看社团活动”换成“查看图书借阅记录”，重写一遍流程。
2. 列出页面最想拿到的 4 个字段。
3. 写一句更容易让初中生听懂的“接口”解释。
4. 用箭头画出“点击 -> 查询 -> 返回 -> 显示”的顺序。长正文素材
text
应用结构实战长正文
这一组课程更接近真正的应用搭建现场。页面导语可以这样写：当一个项目开始有输入框、表单、查询、管理页和多种数据状态时，它就不再只是作品展示，而是在慢慢变成可以处理事情的小应用。学生在这里最需要学会的，不是一次记住所有术语，而是理解每个模块为什么要存在。
主体段一：初始化和文件组织，是为了让项目不乱；表单和验证，是为了让用户输入更可靠；接口，是为了让页面能拿到外部结果；搜索和筛选，是为了让内容一多以后还能找到重点；管理页，则让学生第一次意识到同一个系统里会有不同角色、不同处理入口。把这几件事串起来，学生就会知道应用是如何一步步长起来的。
主体段二：老师这里最适合反复做的一件事，是把复杂功能拉回真实场景。比如图书借阅平台里，学生填借阅申请，老师查列表，管理员看状态；活动平台里，学生报名、老师审核、页面显示结果。只要场景一直稳定，学生对这些新内容的理解就会越来越扎实。
课堂判断语：如果一项功能只是看起来更像大项目，但没有让事情更清楚，就先别急着加；如果一项功能能明显让输入更稳、查找更快、处理更清楚，它就值得先学。
页面收束语：这一类课真正的成长点，在于学生开始从“把页面做出来”转向“让页面真的能处理一件事”。页面文案建议
- 说明句式：页面发出请求，系统处理，结果再回到页面。
- 提示语：先看我要什么，再看我得到了什么。
可替换素材方向
- 先用生活动作举例，不要先讲术语。
- 接口理解重点在流程，不在复杂代码。
主视觉配图
页面示例配图
截图规划示意
60 分钟教学展开
0-15 分钟：还原真实使用场景
讲解推进
- 从“简单 API 的理解”在真实产品里的使用场景切入，让学生知道这不是额外知识，而是完整项目的一部分。
- 结合“页面和数据之间通过什么方式沟通”说明今天这一课为什么会影响作品是否稳定、可用或可发布。
- 明确本课阶段目标是完成“API 调用流程图”，让学生始终围绕可验证的结果推进。
本段知识点
- 先从“简单 API 的理解”的真实使用场景入手，帮助学生知道今天为什么要学这一课。
- 接口可以理解成“页面把需求说出去，系统把结果带回来”的通道。
- 请求里要说清要什么，返回里要看懂得到什么。
建议展示 / 截图
- 请求发出与结果返回的流程图截图
- 简单 API 的理解的课堂任务卡或成果示意图
本段资料与素材
- 一次“查询活动列表”或“提交作业”的流程卡
- 任务说明卡 1 份
本段逐字稿
text
【本段开场】
同学们，先把今天这节课放回一个真实项目里。课题是“简单 API 的理解”，但我们真正要看的是：当系统里开始出现“页面和数据之间通过什么方式沟通”时，项目会发生什么变化。
这一模块把数据、表、接口和管理视角拉进来，重点是让页面真正开始处理信息。
先把情境放回真实项目里去想。假如现在面对的是“页面和系统之间的一次请求与返回”，如果没有今天这一层，这个系统最容易卡在哪里？
我们先看“一次“查询活动列表”或“提交作业”的流程卡”。看示例的时候，不只是看页面长什么样，而是看角色、数据和流程到底是怎样被摆出来的。
先把 API 讲成“页面向外要结果的一种约定”，让学生先理解用途，不先陷进术语。
先把使用场景讲稳，比先记术语更重要。只要学生知道这一层在解决谁的麻烦，后面结构就会顺很多。
这一段先把场景、角色和目标收稳。起点一旦说清，后面系统图和流程线就不会飘。
你们现在先不要急着回答得很大，只要先把“谁、做什么、最后留下什么结果”说清，就已经够用了。
如果页面自己没有答案，它还能从哪里把结果要回来？
等会儿我们会从一个最小例子开始，不是为了把事情讲简单，而是为了把关键关系先讲准。
等会儿我会先把 API 讲成“向外提问”。你们先别急着记名词，先抓住“谁在问、问什么、回来什么”。
这一段一直要记住：开始像一个会让页面处理真实信息的人。只要你开始会判断角色、数据、页面和流程的关系，这节课就已经不只是“多学几个新词”了。
如果到了这一段结束，你还只能说个大概，我们就再回到示例图和流程线多收一遍。系统类的内容一旦关系没收住，后面每加一层都会更乱。
API 这一节先收住：它更像一条约定好的拿结果路径，而不是神秘能力。
【本段收束】请同学们用一句话说出这一段你最确定的一点，再进入下一段。老师演示提示词（给 Codex）
用途：把下面这段直接复制给 Codex，用来生成本段课堂演示页或功能示例。
text
请直接实现一个给八至九年级学生看的“数据与接口教学页”课堂开场页。 本课主题是“简单 API 的理解”，页面场景使用“页面和系统之间的一次请求与返回”。 请直接输出可实现的网页页面，优先使用单文件 HTML（内含 CSS 和 JavaScript），不要只给方案说明。 页面必须包含：数据表或字段区、页面输入或输出区、处理流程区、结果反馈区。 核心内容请围绕“页面和数据之间通过什么方式沟通”来实现。 页面重点突出：数据和页面为什么必须配合。 页面要让人一打开就知道这页在做什么。 首屏要有主题说明、核心内容区和一个明确入口，可以保留一个开始按钮或继续入口。 页面排版要清楚，标题醒目，分区明确，按钮和反馈明显。除了界面，还要把角色、数据、流程或状态关系讲清，不要只做外观示意。课堂动作
- 先用 1 到 2 分钟让学生说出自己对“简单 API 的理解”最直观的理解，再进入示例页。
阶段成果
- 完成本课任务目标和阶段成果的确认。
15-30 分钟：讲清关键流程与边界条件
讲解推进
- 把“页面和数据之间通过什么方式沟通”拆成具体流程，例如先发生什么、再检查什么、最后如何确认结果。
- 通过流程图、数据流或操作顺序说明关键节点，帮助学生建立工程化的顺序感。
- 强调常见边界条件与风险点，让学生知道哪里最容易出错、最需要回看。
本段知识点
- API 可以先理解成“页面和数据沟通时走的一条通道”，先讲作用，再讲名称。
- 把“页面和数据之间通过什么方式沟通。”拆成可观察、可操作的页面结构或流程关系。
- 接口可以理解成“页面把需求说出去，系统把结果带回来”的通道。
- 请求里要说清要什么，返回里要看懂得到什么。
建议展示 / 截图
- 页面按钮、接口动作和返回内容三栏对照图
- 简单 API 的理解的结构草图、流程图或区域标注图
本段资料与素材
- 请求与返回示意图
- 结构草图模板 1 份
本段逐字稿
text
【本段开场】
现在我们不急着继续堆功能，先把这节课最关键的关系拆开。只要这一段能听明白，后面很多看起来复杂的词都会落到具体动作上。
这一模块把数据、表、接口和管理视角拉进来，重点是让页面真正开始处理信息。
这一段继续围绕“页面和系统之间的一次请求与返回”往下看。我们不是再换一个新例子，而是把同一个场景里的结构关系真正拆开。
这一段继续借“请求与返回示意图”来拆关系。你们要边看边判断：这一块到底是在交代页面、数据，还是流程。
把请求、处理、返回结果三步拆开，帮助学生把接口看成一条顺着走的信息交换线。
这一段最怕的是把关系讲散。我们要一直顺着“谁在用、谁处理、结果去哪”这一条线往下走。
这一段最关键的是把复杂内容讲成顺着走的关系。先看谁在用，再看谁处理，最后看结果去哪。
这一步要不断追问：它到底在系统里负责哪一层？如果答不上来，就说明关系还没有收稳。
请求发出去以后，页面最需要等待的是什么？
接下来这几分钟，你们要重点听“关系”而不是只听名词。名词可以晚一点记，关系不能听散。
这一段我会一直顺着“请求 - 处理 - 返回”讲，不让接口看起来像凭空出现的黑盒。
这一段一直要记住：开始像一个会让页面处理真实信息的人。只要你开始会判断角色、数据、页面和流程的关系，这节课就已经不只是“多学几个新词”了。
如果到了这一段结束，你还只能说个大概，我们就再回到示例图和流程线多收一遍。系统类的内容一旦关系没收住，后面每加一层都会更乱。
只要请求、处理、返回这三步开始顺了，接口就不会再显得飘。
【本段收束】请同学们用一句话说出这一段你最确定的一点，再进入下一段。老师演示提示词（给 Codex）
用途：把下面这段直接复制给 Codex，用来生成本段课堂演示页或功能示例。
text
请直接实现一个给八至九年级学生看的“数据与接口教学页”结构拆解页。 本课主题是“简单 API 的理解”，页面场景使用“页面和系统之间的一次请求与返回”。 请直接输出可实现的网页页面，优先使用单文件 HTML（内含 CSS 和 JavaScript），不要只给方案说明。 页面必须包含：数据表或字段区、页面输入或输出区、处理流程区、结果反馈区。 核心内容请围绕“页面和数据之间通过什么方式沟通”来实现。 页面重点突出：把数据表、读写动作和结果展示拆开讲透。 页面要把区块分工、流程顺序或阅读路径讲清。 请用分区标题、编号、箭头、步骤标签或结构图，把每一块分别负责什么写清楚。 页面排版要清楚，标题醒目，分区明确，按钮和反馈明显。除了界面，还要把角色、数据、流程或状态关系讲清，不要只做外观示意。课堂动作
- 用“提交报名表”这样的动作，带学生看页面为什么不能直接替数据库做所有事。
- 带学生一起把今天的页面、流程或知识结构画成一张简单草图，边讲边标注。
阶段成果
- 形成一张结构图、分区图或流程图草稿。
30-45 分钟：按步骤完成核心操作
讲解推进
- 按照清晰步骤完成“API 调用流程图”的主体部分，让学生把今天讲到的流程真正走一遍。
- 要求学生边做边记录“页面和数据之间通过什么方式沟通”落在项目中的具体位置，而不是只追求最终跑通。
- 讲师及时处理最容易卡住的操作环节，并提醒学生保留关键截图、日志或流程说明。
本段知识点
- API 的价值不在术语，而在它把动作拆成了可传递、可返回的一段流程。
- 在动手环节里，把“API 调用流程图。”做成真正能演示的结果。
- 请求里要说清要什么，返回里要看懂得到什么。
- API 先理解成流程关系，比先背术语更重要。
建议展示 / 截图
- 接口结果被展示到页面列表中的局部截图
- API 调用流程图。正在完成中的过程截图
本段资料与素材
- 接口说明小卡：我要什么、我收到什么
- API 调用流程图。的半成品模板
本段逐字稿
text
【本段开场】
下面开始看最关键的一轮演示。今天这一段不求做很多，而是要把一条最短闭环跑顺，让你们看见结果是怎样真的出现的。
这一模块把数据、表、接口和管理视角拉进来，重点是让页面真正开始处理信息。
现在把“页面和系统之间的一次请求与返回”里的关键动作跑起来。只要这一轮动作能看顺，学生就会知道系统不是停在示意图上。
接下来还是先盯住“接口说明小卡：我要什么、我收到什么”。今天这一步不是看热闹，而是看最关键的一轮动作怎样真的跑起来。
现场跑一轮最小请求示范，让学生看见“问出去”和“拿回来”到底发生了什么。
动手时只盯最关键的动作链。只要“API 调用流程图。”的核心闭环跑通，今天这节课就已经有真实结果。
动手时先保最短闭环。只要今天这条“API 调用流程图。”核心链路真的跑起来，系统就已经站住一大半。
如果演示一跑就乱，先回到最短流程，不要一边加功能一边猜问题会不会自己消失。
接口返回的内容是直接给人看，还是先要被页面整理一次？
下面这一段我会先演示，再回头解释。你们先看顺序，再看每一步分别落在哪一层。
接下来我会跑一轮最小示范，让你们看见结果回来以后，页面为什么还要再整理一下才能展示。
这一段一直要记住：开始像一个会让页面处理真实信息的人。只要你开始会判断角色、数据、页面和流程的关系，这节课就已经不只是“多学几个新词”了。
如果到了这一段结束，你还只能说个大概，我们就再回到示例图和流程线多收一遍。系统类的内容一旦关系没收住，后面每加一层都会更乱。
这一课最值钱的，是你开始知道页面并不是什么都要自己准备。
【本段收束】请同学们用一句话说出这一段你最确定的一点，再进入下一段。老师演示提示词（给 Codex）
用途：把下面这段直接复制给 Codex，用来生成本段课堂演示页或功能示例。
text
请直接实现一个给八至九年级学生看的“数据与接口教学页”功能演示页。 本课主题是“简单 API 的理解”，页面场景使用“页面和系统之间的一次请求与返回”。 请直接输出可实现的网页页面，优先使用单文件 HTML（内含 CSS 和 JavaScript），不要只给方案说明。 页面必须包含：数据表或字段区、页面输入或输出区、处理流程区、结果反馈区。 核心内容请围绕“页面和数据之间通过什么方式沟通”来实现。 页面重点突出：做出一轮真实的读写或查询演示。 页面要做出最关键的一轮功能演示，让操作、反馈和结果连成闭环。 必须支持至少一轮真实动作，例如点击、输入、切换、提交、答题、反馈或状态变化，并且操作后立刻出现结果。 页面排版要清楚，标题醒目，分区明确，按钮和反馈明显。除了界面，还要把角色、数据、流程或状态关系讲清，不要只做外观示意。课堂动作
- 讲师边投屏边带做，让学生至少独立完成一次最关键动作。
阶段成果
- 要求学生把一次“提交-保存-返回结果”的过程画成简单箭头图。
- 拿到“API 调用流程图。”的可演示版本。
45-60 分钟：检查规范、记录问题并沉淀方法
讲解推进
- 围绕“页面和数据之间通过什么方式沟通”检查结果是否稳定，包括边界输入、异常情况或不同页面之间的配合。
- 把今天的“API 调用流程图”沉淀成一份可复用的方法记录，方便后续课程继续调用。
- 最后统一回顾本课流程，让学生把“知道怎么做”提升到“下次还能独立重做”。
本段知识点
- 通过检查、互评和整理，让学生知道这节课的成果怎样继续进入下一课。
- API 先理解成流程关系，比先背术语更重要。
建议展示 / 截图
- API 调用流程图。最终整理后的展示截图
- 同伴互评或发布前检查清单截图
本段资料与素材
- 检查清单 1 份
- 结尾展示顺序卡 1 份
本段逐字稿
text
【本段开场】
最后这一段我们不再继续加内容，而是把今天的结果讲清楚、收整齐。能不能把“API 调用流程图。”说顺，决定这节课到底有没有真正站住。
这一模块把数据、表、接口和管理视角拉进来，重点是让页面真正开始处理信息。
最后再回到“页面和系统之间的一次请求与返回”这个场景里看一遍结果。系统讲到这里，要能让别人听懂它为什么值得继续做下去。
最后回头看“检查清单 1 份”，重点不在多加内容，而在把已经做出来的结果讲顺、收稳、讲明白。
收束成一套接口理解法，让学生最后能说出接口在项目里最像哪一个角色。
这一段的重点不是再扩内容，而是把结果说得清、顺、稳。能复述清楚，才是真的学会了。
这一段收尾时先把结果讲顺、看顺、检查顺。能复述清楚，才是真的会了。
收尾时先看逻辑有没有闭合，再看表达是不是顺。讲不顺的地方，通常也是理解还没彻底收住的地方。
你现在能不能说出 API 和数据库最大的不同？
最后我会请大家把结果倒着讲一遍：先说今天拿到了什么，再说它是怎样一步步出来的。
最后我会请大家判断：如果没有 API，这一节里哪个功能最难实现。
这一段一直要记住：开始像一个会让页面处理真实信息的人。只要你开始会判断角色、数据、页面和流程的关系，这节课就已经不只是“多学几个新词”了。
如果到了这一段结束，你还只能说个大概，我们就再回到示例图和流程线多收一遍。系统类的内容一旦关系没收住，后面每加一层都会更乱。
记住，接口真正重要的地方，在于它让系统开始能和外部世界沟通。
【本段收束】请同学们用一句话说出这一段你最确定的一点，再进入下一段。老师演示提示词（给 Codex）
用途：把下面这段直接复制给 Codex，用来生成本段课堂演示页或功能示例。
text
请直接实现一个给八至九年级学生看的“数据与接口教学页”收束展示页。 本课主题是“简单 API 的理解”，页面场景使用“页面和系统之间的一次请求与返回”。 请直接输出可实现的网页页面，优先使用单文件 HTML（内含 CSS 和 JavaScript），不要只给方案说明。 页面必须包含：数据表或字段区、页面输入或输出区、处理流程区、结果反馈区。 核心内容请围绕“页面和数据之间通过什么方式沟通”来实现。 页面重点突出：把数据页整理成可继续扩展的版本。 页面要把当前结果整理成适合展示和收束的版本。 页面里要保留结果展示、小结、检查点或下一步，让成果能够直接拿来展示。 页面排版要清楚，标题醒目，分区明确，按钮和反馈明显。除了界面，还要把角色、数据、流程或状态关系讲清，不要只做外观示意。课堂动作
- 安排结对互看或小组展示，让学生把自己的结果讲成一段完整说明。
阶段成果
- 把今天的结果整理成可展示、可提交、可继续修改的版本。
课后作业
必做任务
- 把“我在页面里点了一次按钮，系统背后发生了什么”写成三步话。
- 把课堂上的“API 调用流程图。”再补一个更完整的细节，并保留前后对比。
提交建议
- 提交本课产出：API 调用流程图。
- 附 2 到 3 句说明：你今天做了什么、最满意哪里、还准备改什么。
自查清单
- 我能说清楚这节课做的页面或流程是给谁用的。
- 我能指出页面里最重要的一个区块、一个动作和一个结果。
- 我保存了课堂过程中的草图、截图或记录，方便下次继续。
相关参考
appendix/4-server-and-backend/api-intro.md