php - RESTful API 路径设计指南

Question

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

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

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

Answer 1

参数用于过滤查询：

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

路径用于获取元素：

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

所以，我推荐你使用myapi.com/users/{userid}.

从这个精彩的演示文稿跳到幻灯片 60 （我建议您阅读）。