哪个URL描述的资源最好？

Question

/competitions/1/clubs/5/players
/players/search?club_id=5
/players?club_id=5

什么时候应该对资源使用一流的URL，什么时候应该使用嵌套的URL？

更新1

到目前为止谢谢你的回答。我会尽量进一步澄清问题。

竞争和俱乐部之间有很多种关系。俱乐部可以参加多种比赛。我想这将使俱乐部成为一个一流的实体，因此，进入俱乐部的方式应该是：

/clubs/33

但我也需要能够接触参加特定比赛的俱乐部，所以我也需要这样的东西：

/competitions/2/clubs

但是有人提到，通过多个URI访问一个资源是不可取的，这不违反这一点吗？

此外，我认为这样的URI并不可取：

/competitions/2/clubs/33/players/5

而是使用这个：

/clubs/33/players/5

俱乐部和球员有一对多的关系。

Answer 1

我使用路径元素，如果关系“感觉”树/目录明智(就像俱乐部有球员/clubs/berlin/players)。参数是更多的“标签”，我经常使用它进行搜索-过滤器(例如‘柏林’俱乐部的捍卫者，年龄在22岁的/clubs/berlin/players?position=defender&age=22)。

我设计URL结构的‘域-重要性’。最基本的概念应该从根本上讲。如果可能的话，不要太深入url-结构，我尽量不复制或创建表示相同资源的别名集合(代码+文档中的维护成本加倍)。

通常，将/clubs作为根的感觉更自然：/clubs/{club_id}/players

我只会暴露球员通过/competitions/{comp_id}/clubs/{club_id}/players，如果球员的集合是不同的/clubs/{club_id}/players，例如，在比赛期间，有几个球员被封锁或没有参加比赛阵容。

你说/competitions是什么意思？是一场比赛还是一场比赛？如果与两家俱乐部的单场比赛可能使用主场+客场域名-概念：/competitions/{comp_id}/home-club和/competitions/{comp_id}/away-club。

更新-1答复

以下是我对你的更新问题的想法：

我想/competitions/2/clubs是/clubs的一个子集，并不是每个俱乐部都在竞争。所以这两种资源是不同的，所以两个URL都很好。

再次考虑一下，/competitions/2/clubs/33/players/5也应该是好的(但是在服务器中避免代码重复是很重要的)。当返回的资源是/clubs/33/players的一个子集时，这个URL甚至应该是强制性的(例如，球员受伤了，或者球队规模的限制被打到了特定的比赛中)。

Answer 2

我不会把ID号码放在URL里。它们只对那些真正知道它们的含义的人意味着什么，但对其他人来说，它们是毫无意义的数字。

您应该始终为您的URL选择描述性和相关的单词，因为URL有助于提供有关链接资源的信息。

与其使用无意义的ID号码，不如选择一个表示团队名称或竞赛名称的唯一名称，例如

/competitions/worldcup/clubs/usa/players

但是如果您真的需要在URL中发送这种匿名数据，那么我更愿意在查询中看到它们。

只对URL使用有意义的文本。