何时在RESTful API中使用嵌套资源

我有两个资源：用户和链接。

用户可以具有几个与之关联的链接。我已经设计了RESTful API，以便您可以通过以下URI访问与用户关联的链接：

/users/:id/links

但是，我总是需要一个仅用于链接的URI –有时我可能想要所有链接，无论用户是谁。

为此，我有：

/links

听起来还好吗？有两个链接的URI吗？

我想知道是否应该使用URI来访问用户的链接，例如：

/links/user/:id 要么 /links/?user=:id

这样，我只有一个链接资源。

不，对于同一个“事物”拥有多个资源没有什么错，在这种情况下为链接列表。

我们最近正面临着同样的问题。我们的决定是将所有没有严格所有权的资源都嵌套。换句话说，链接将在以下条件下建模

/links -- all links
/links/:linkid -- a particular link

然后，链接集合上的过滤器表示为查询参数。因此，要获取某个用户的链接，可以使用：

/links?user=/users/:userid

这也使过滤器的组成更加容易：

/links?user=/users/10&since=2013-01-01

从概念上很容易理解-您有一组项目，并向其中添加了过滤器。

话虽这么说，没有比其他任何URI命名方案更“ RESTful”的了。这只是我们发现的一种惯例，使我们的开发人员易于理解和接受。REST不在乎您在资源标识符中放入什么。

因此，我担心的是：/ users /：userid / links返回“链接”，但如果未标识user_id，则应返回404。

然而

/ links？userid =：userid可能会返回一个空列表（实际上是200），这实际上可能是一个错误。而且很有可能。

尽管两者都起作用，但嵌套为您提供了其他功能，您可以在以后使用。