RESTful API 路径设计指南

Question

我想知道一个restful API，以下哪个更实用？

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

当我们应该在 URL 参数与路径中传递参数时，我只是感到困惑。

Answer 1

参数用于过滤查询：

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

和path用于获取元素：

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

所以，我建议你使用myapi.com/users/{userid}。

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