路由与端点
Route & Endpoint
中级通用路由（Route）是后端按请求路径和方法分派处理逻辑的规则；端点（Endpoint）是客户端可调用的具体入口。它们让前端请求能找到对应功能，例如读取订单和创建订单分别交给不同的处理逻辑。
你可能会说：「我想让前端用同一个订单地址读取和新建订单，后台能分清该执行哪个操作。」
动手看看查看与创建订单
用户打开订单详情，页面发出 GET /orders/42。请求的方法和路径一起指向这个读取订单的端点。
要点一个请求怎样找到对应的后端功能？
- 1
路由负责把请求分派出去
你可以把路由理解成后端的匹配规则。请求进来后，后端根据路径、HTTP 方法等信息，找到处理它的代码。比如同样是 /orders，读取订单列表和创建订单可以走不同逻辑。
- 2
端点是客户端调用的入口
前端要获取订单列表，得知道请求发到哪里、用什么方法。这个可调用的入口通常就叫端点。谈端点时最好把方法也说上，因为 GET /orders 和 POST /orders 虽然路径相同，执行的操作却不同。
- 3
路径参数把具体对象带进来
当你要查看某一笔订单时，可以用 GET /orders/123。后端用带参数的路由匹配这类请求，再从路径中取出订单编号。这样一条路由就能处理不同订单，不用为每笔订单单独写规则。
容易混淆的地方
路由是后端决定“这个请求交给谁处理”的规则，端点是客户端视角下“可以调用哪个入口”；日常交流中两者常被混用。它们也不等于整个 API：API 还包括请求参数、返回数据和错误约定。单独一个 URL 也不一定说清了端点，因为相同路径配上不同 HTTP 方法，可能对应不同操作。
什么时候用
适合用
- 你在做订单管理后台，需要让前端分别读取订单列表、创建订单和查看单笔订单时，用路由与端点说明各请求怎么进入后端。
- 你让 AI Agent 接入已有后端，需要确认每个功能调用的请求方法、路径，以及路径里的编号从哪里来。
- 你排查前端请求得到 404 或调用了错误功能的问题，需要核对请求是否匹配后端已有的路由。
不适合用
- 只是让用户从商品页跳到购物车页时，通常是在做页面导航；先用前端链接或页面路由，不必为跳转新建后端端点。
- 只是让页面上的详情面板展开或收起，状态可以留在前端组件里，不需要为每次点击设计后端端点。
- 要在固定时间自动清理过期文件，且没有外部调用需求时，用定时任务更直接，不必为这项工作开一个供客户端调用的端点。
练一练选一个答案，看看解释
你在做订单后台：列表页要读取订单，表单提交后要创建订单。两项功能都想使用 /orders。该怎么向 AI Agent 描述？
让 AI 帮你做复制给 AI Agent 直接用
请为订单后台设计并实现路由与端点：GET /orders 返回订单列表，GET /orders/:id 返回单笔订单，POST /orders 创建订单。请沿用项目现有后端框架，说明每个端点接收什么、返回什么，并补上对应测试；不要让前端直接访问数据库。