后端
接口端点Endpoint
你可能会问
接口端点到底是什么？它和 API 是一回事吗？
简单来说
API 中处理某一类请求的具体地址，例如 /api/search。
同一个地址
方法GETPOST
路径/orders
方法不同，就是菜单上不同的菜
01 · 先这样理解
把抽象概念放进真实场景
API 中处理某一类请求的具体地址，例如 /api/search。
换个角度想如果 API 是整本菜单，Endpoint 就是菜单上的一道菜：/orders 是「订单」这道菜，GET 是看一份、POST 是来一份——地址加动作，唯一确定你点的是什么。
02 · 点击演示
一个地址，怎么装下查和建？
突出显示的部分，就是当前概念在整条流程中负责的位置。
- 按资源分地盘
/orders订单们/orders/4242 号订单/users用户们 查：拿一份数据，不改变任何东西
建：新增一条数据
删：移除一条数据
/orders/42
路径点名：第 42 号订单
get /orders/42
200返回 42 号订单详情查，是这道菜的本分204删掉了，没有内容需要返回204 的意思是「办妥了，没啥可说的」405这个地址没有 POST 这道菜方法也得在约定里——不是所有地址都能「来一份」
1 / 4
Path · 一条具体的地址
03 · 放进真实任务
什么时候会遇到它
拆解需求
「加个收藏功能」，翻译过来就是新增 POST /favorites 和 DELETE /favorites/:id。
看懂报错
404 常常是 endpoint 地址写错了，不一定是数据不存在。
对照文档
API 文档就是 endpoint 清单：地址、方法、参数、返回。
04 · 想一想
用一个问题检查理解
GET /orders 和 POST /orders，是同一个 endpoint 吗？
查看答案
不是。地址相同但方法不同，就是两个 endpoint：GET /orders 查订单列表，POST /orders 创建新订单——背后对接的是两段不同的处理代码。
最容易踩的坑
Endpoint 的命名就是它的说明书：用资源名词（/orders），别用动词（/getOrderList）。风格统一，AI 和队友都能猜对下一个地址长什么样。