对照
| 做法 | 推荐写法 | 说明 |
|---|---|---|
| 资源命名 | GET /orders/123 | 名词复数，层级表达从属 |
| 动作 | POST /orders/123/cancel | 无法映射到标准方法时用子资源动作 |
| 避免 | GET /getOrder?id=123 | 动词入路径，语义与缓存都受影响 |
REST 约束不止“用 JSON 加 HTTP”：统一接口、无状态、可缓存与分层系统是常被忽略的部分。
REST 与资源建模
REST 以资源为中心组织接口，用统一接口与表述（representation）操作资源状态；资源名用名词复数、通过链接表达关系，避免在路径里塞动词。
易错点
- 按界面逻辑设计资源，接口随页面频繁变动
- 所有操作都用 POST 单一路径，放弃 HTTP 语义
数据来源与参考
- Roy Fielding 博士论文（2000）第 5 章
- RFC 9110 HTTP Semantics