我正在研究 Github 的 REST API 并偶然发现了一些奇怪的 URL。Github 有两个主要资源 /user 和 /users，其中 /user 指的是经过身份验证的用户和 /users 两个任何特定用户。
这不违反 URN 的定义吗？主要是因为这两点：
- 有两个不同的标识符引用同一个实体。
- /user 并不唯一地代表一个资源，但即使针对成功的请求，也会对每个人给出不同的响应。
问问题
28 次
1 回答
2
有两个不同的标识符引用同一个实体。
这是完全有效的——见菲尔丁，2000 年；拥有许多具有重叠甚至等效表示的不同资源是完全正常的，当然这些表示可能是使用来自公共实体的信息产生的。
当然，需要权衡取舍 -此资源成功处理不安全请求不会使该资源的缓存响应无效；参见RFC 7234。
/user 并不唯一地代表一个资源，但即使针对成功的请求，也会对每个人给出不同的响应。
这个比较乱
TL;DR 版本在 HTTP 中是可以的，因为我们有特殊的规则来缓存对经过身份验证的请求的响应。
更长的版本是我们已经有了一个单一资源可能有多个有效表示的概念。我们可以使用主动或被动的内容协商来确定在对客户端的响应中包含哪种表示，我们有Vary标头来帮助缓存了解何时可以重用响应，等等。
XML 文档和 JSON 文档应该是两个不同的资源吗？还是同一资源的两种不同表示？英文文档和法文文档应该是两个不同的资源还是同一资源的两个不同表示？
在某些情况下，“同一资源的不同表示”答案是有意义的，因此“给出不同的响应”不一定是向下检查。
当然，授权不仅仅是内容协商，就像 Accept 和 Accept-Language 一样。所以我们有特殊的规则：
无需在 Vary 中发送授权字段名称，因为跨用户的重用受到字段定义的限制——RFC 7231
总之，这当然是一种允许的设计。它是否也是一个好的设计，部分取决于他们需要满足的约束集合。
在设计评审中，如果没有必要的约束，我会拒绝 Github 设计——在我看来，关于 Alice 的文档和关于 Bob 的文档是不同的资源（改变一个不会改变另一个），并且应该清楚被贴上这样的标签。
但如果设计师就这么受约束呢？装运它。
于 2021-08-04T15:58:48.817 回答