http - 哪个 URL 最能描述资源？

Question

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

什么时候应该为资源使用一级 URL，什么时候应该使用嵌套 URL？

更新 1

感谢您到目前为止的回答。我会尝试进一步澄清一些事情。

Competition 和 Club 是多对多的关系。俱乐部可以参加多项比赛。我想这会使俱乐部成为一流的实体，因此访问俱乐部的方式例如:

/clubs/33

但我还需要能够访问参加特定比赛的俱乐部，所以我也需要这样的东西:

/competitions/2/clubs

但是有人提到不推荐通过多个 URI 访问资源。这不违反那个吗？

此外，我认为这样的 URI 不是更可取的:

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

而是使用这个:

/clubs/33/players/5

Club 与 Player 是一对多的关系。

Answer 1

/competitions/1/clubs/5/players

由于 URI 是单个资源的标识符，我想说的一般规则是，如果它是一个对象，它会获得一个“一流的 URL”。

我只倾向于在限制/过滤列表时才使用查询参数，例如，/competitions/1/clubs/5/players?gender=MALE。