web-services - 您应该在 URL 中使用复数形式还是单数形式的文件夹名称

Question

示例 1:

http://www.example.com/image/logo.png
http://www.example.com/images/logo.png

示例 2:

http://www.example.com/user/johndoe
http://www.example.com/users/johndoe

特别是如果您将 Url 用作 REST API。 (例二)

推荐哪一个？为什么？

Answer 1

对于REST，我主要使用复数形式来表示资源的路径。但是您还必须考虑资源的可缓存性、更改频率和可变性。就我而言，资源的集合主要是这样，所以我只好使用复数形式。

这样做的原因是例如:

http://www.example.com/users/johndoe

将提供 URI 以获取属于您的用户集合的用户 johndoe。

http://www.example.com/users

将用作获取所有用户的 URI，并且可以很容易地用于查询 url，例如:

http://www.example.com/users?limit=5

创建新用户仍将使用相同的 URL，然后使用 POST 并传递参数:

http://www.example.com/users

对于 refs，您可能需要查看 Oreilly 书 RESTful Web Services Cookbook