你可能会说:
- “前端是怎么从后端拿到数据的?”
- “AI 说"调用一下这个 API",API 到底是什么?”
它是什么
前端需要数据时,向后端的某个地址发一个请求,比如 GET /api/content/terms,后端返回一段 JSON。每个地址叫一个端点,它接收什么参数、返回什么结构、出错时回什么状态码,合起来就是这个 API 的约定。
接口也可能来自别人:地图、支付、大模型都通过 API 对外提供服务。调用别人的 API 通常要带上密钥,按次或按量计费,所以这类调用一般放在后端做,密钥不出后端。
好的接口出错时会说清楚:找不到返回 404,没登录返回 401,服务器出错返回 500,并附上原因。最糟的是出了错还返回 200,调用方就会把错误当成正常数据用下去。
打个比方
像餐厅的传菜窗口和点菜单:大堂按固定格式写单子递进去,后厨按固定格式把菜递出来。双方不用走进对方的地盘。
在这个网站里
兄弟项目 E2E Review 的前端全部通过 /api/ 开头的地址向后端要数据:术语、论文、登录、学习进度、AI 导师。它的请求封装有个隐患:如果收到的不是 JSON 而是一张网页,解析失败会被悄悄当成空对象,调用方看到的是一次"成功"(第 5 课)。
容易搞混的地方
常见误解
API 就是一个网址
正确理解
网址只是入口。API 还包括请求方法、参数、返回格式和出错规则,缺哪样都会对不上。
你可以这样告诉 AI
复制下面这段,贴给你的 AI
列出这个项目用到的全部接口:自己后端的和第三方的,各自的地址、方法、参数、返回格式,以及每种错误返回什么状态码。第三方接口的密钥放在哪?
接下来去哪
先知道
接着看
- HTTP 状态码——服务器回应每个请求时附带的三位数字,告诉对方这次是成功、找不到,还是出错了。
在这些课里出现