RESTful API路径设计指南

Question

我想知道一个宁静的API，以下哪个更实用？

1. myapi.com/users/ {用户ID}
2. myapi.com/users?userid= {用户ID}

当我们应该在URL Param和Path中传递参数时，我感到很困惑。

Answer 1

Params用于过滤查询：

http://www.acme.com/products/?filter=cats&sort=des

路径用于获取元素：

http://www.acme.com/products/1234

因此，我建议您使用myapi.com/users/{userid}。

从this great presentation跳转到幻灯片60（我建议您阅读）。