换个角度想
如果 API 是整本菜单,Endpoint 就是菜单上的一道菜:/orders 是「订单」这道菜,GET 是看一份、POST 是来一份——地址加动作,唯一确定你点的是什么。
术语 · 后端
Endpoint
API 中处理某一类请求的具体地址,例如 /api/search。
一本菜单,一道道菜
方法GETPOST
路径/orders
如果 API 是整本菜单,Endpoint 就是菜单上的一道菜:/orders 是「订单」这道菜,GET 是看一份、POST 是来一份——地址加动作,唯一确定你点的是什么。
/orders订单们
/orders/4242 号订单
/users用户们
查:拿一份数据,不改变任何东西
建:新增一条数据
删:移除一条数据
/orders/42
路径点名:第 42 号订单
get /orders/42
一条具体的地址
「加个收藏功能」,翻译过来就是新增 POST /favorites 和 DELETE /favorites/:id。
404 常常是 endpoint 地址写错了,不一定是数据不存在。
API 文档就是 endpoint 清单:地址、方法、参数、返回。
GET /orders 和 POST /orders,是同一个 endpoint 吗?
不是。地址相同但方法不同,就是两个 endpoint:GET /orders 查订单列表,POST /orders 创建新订单——背后对接的是两段不同的处理代码。
Endpoint 的命名就是它的说明书:用资源名词(/orders),别用动词(/getOrderList)。风格统一,AI 和队友都能猜对下一个地址长什么样。