rest-conventions

为任何 HTTP API 设计 REST 资源时，路径名称应表示资源，HTTP 方法表示操作动词。URL 中不应包含 `/list`、`/update`、`/getUser` 或其他 RPC 风格的动词。涵盖集合与成员 URL、方法语义、状态码、PUT 与 PATCH 的区别、将过滤器作为查询参数、为非 CRUD 操作提供的“逃生通道”、错误格式、幂等性以及版本控制。 触发条件：添加、重命名或审查 HTTP 端点、路由或控制器；设计 URL、选择方法或状态码；路径中包含动词、`?action=` 参数或读起来像函数调用；建模一个明显不属于创建/读取/更新/删除的操作；编写 OpenAPI 文档；用户询问关于 REST、端点命名或资源设计的问题。 跳过条件：接口明确不采用 REST 风格（如 gRPC、GraphQL、JSON-RPC、Webhook 接收器、标准强制要求的端点），或当前未设计 HTTP 接口。同时加载 `api-conventions` 以了解载荷约定。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本