第三单元 数据表与 API
第12课 完成：API 接真库
接口是窗口：约定路径与字段，页面才能接到真表。
接到真表：关网页再开，赞还在。
这是从玩具到作品的门槛。
演示时故意刷新一次，效果最好。
一、这一课怎么学
- 开始前你要会：会打开浏览器，会打字。
- 怎样算做完：完成「轮到你做」，并在嵌入工具里留下可预览文件。
- 建议：先读「弄懂这件事」，再做练习。
二、学完你能做到
- 能写出一个接口约定。
- 能说明与本机 v1 的差别。
- 尽量做出刷新仍在（按教室基建）。
三、弄懂这件事
这一课就这几小步：
1．窗口
接口可以想成约定好的窗口：走哪条路径、用什么方法、请求带什么、响应回什么。
把这四样写清，页面和服务才说同一种话。
窗口对不齐，就会出现「发出去了却看不见」。
2．约定
要分清本机数组和服务表：前者像草稿本，后者像全班共用的本子。
接到真表后，关网页再开，赞还应该在。
这是从玩具到作品的门槛。
3．验收
验收很简单：提交→刷新→还在。
演示时故意刷新一次，效果最好，也最能打消「只是假象」的怀疑。
通了再准备进入登录与审核流。
点一点就明白
点下面的按钮，看屏幕上发生了什么。
四、先跟着做
对照例子想清楚
用自己的话重述本课成功标准。
做对了会怎样你写出来的标准，别人打开页面点几下就能核对是不是做到了，而不是只有形容词。
指出哪一步必须自己点，不能听 AI 口头说完成。
做对了会怎样你明确写出：必须自己打开页面点一遍；AI 口头说「完成了」不能算数。
五、轮到你做
接到真表
写一条提交接口约定。
做对了会怎样表或对象里写出了需要的字段名。
做不出来怎么办POST /posts，字段含 to、content、status。
把 v1 提交改为走约定（按教室环境）。
做对了会怎样你能讲清这一次只改了哪一处、为什么。
做不出来怎么办对照 SDK 或示例代码里的字段名来填。
验收：刷新仍在。
做对了会怎样审核通过后状态变为通过（或已通过），对方可见。
做不出来怎么办先在示范墙把提交跑通，再接到自己的作品。
用下面嵌着的氛围编程工具。写完在工具里看预览，文件是
show/l12.html。做对了会怎样在嵌着的工具预览里，你能亲眼看见本课要求的按钮、分数或流程文字，而不是只有说明。
做不出来怎么办先在预览里自己点一遍；文件名必须和例子上写的完全一样，改完再刷新预览。
本节例子
下面整段是给 AI 的提示词示例：写清目标、范围和怎样算做成；请整段使用，不要只丢半句。工具嵌在下方。本课文件是 show/l12.html。
做单个 HTML，标题「接口约定」。 写清两条窗口：提交、列表——各自的路径、字段、成功时大概响应什么。 页底写验收标准：刷新后数据还在，才算接到存储。不要伪称已买云。
正在打开氛围编程工具…若长时间空白请强制刷新。
六、小心这些错
无约定就乱猜字段。
接了口却不测刷新。
七、带走这几句
- 接口就是约定好的窗口：传什么、回什么，先写清。
- 刷新页面后数据还在，才算真正接到存储/表。
八、打勾再往下
- 有接口约定。
- 刷新验收做过。
小测验
对照上面「学完你能做到」选一个答案，再点「检查」。
接口首先是？
接到真表的验收？
与 v1 差别？