api - Restful api结构

Question

简单地说，什么更好？

API 方法：

GET videos/getall
GET videos/get?id=1

GET news/getall
GET news/get/?id=1

GET blogs/getall
GET blogs/get?id=1

或者

GET content/getall/?type=videos
GET content/getall/?type=news
GET content/get?id=1&type=blogs

第一种方法看起来不像 DRY。但它有一些优点。那么有什么更好的方法呢？

Answer 1

所有这些 URI 都是错误的。它们包括将您的 URI 转换为常规 RPC 调用的操作信息（即 getall 和 get）。

您可以选择更简单的方法：

GET /videos
GET /videos/1

GET /news
GET /news/1

GET /blogs
GET /blogs/1

HTTP GET 已经意味着您正在检索数据。