后端

路由与端点Route & Endpoint

你可能会说

用户访问不同的网址，怎么让不同的代码来接管？

路由决定访问一个网址或执行一种操作时，应交给后端的哪段功能处理。例如打开文章列表和提交一篇新文章，会交给两段不同功能处理。每个对外入口都要写清需要提供什么、成功后返回什么、失败时怎样说明。

也常被叫作路由EndpointAPI Endpoint接口端点

GET/api/posts→ 列表处理

POST/api/posts→ 创建处理

GET/api/posts/:id→ 详情处理

方法和路径一起决定进哪段代码

组成结构 · Anatomy

GET/api/posts?page=2

GET 读取、POST 创建、PATCH 修改、DELETE 删除

资源地址，最好使用名词并保持复数规则一致

用于筛选、搜索、排序和分页，不应该包含密码或令牌

典型使用场景

GET /api/posts 取列表

文章列表GET /api/posts

请求参数?page=2&tag=design → 响应200 · 20 篇文章

POST /api/login 提交登录

提交登录POST /api/login

邮箱oil@example.com密码••••••••登录

请求体携带账号信息，成功后建立会话

GET /api/users/:id 取详情

用户详情GET /api/users/:id

路径参数id = u_23姓名林小狐角色editor

DELETE /api/tasks/:id 删除任务

删除任务DELETE /api/tasks/:id

任务整理首页文案删除后按产品策略处理

确认删除

先确认，再请求 DELETE /api/tasks/t_42