REST 子/子资源单个实体

Question

我很难思考如何为子资源建模。

以作者的书籍为例。你可以有 N 本书，每本书只有一位作者。

/books GET
/books POST
/books/id PUT
/books/id DELETE 

到目前为止很简单。

如何为一本书添加作者。至少在这个例子中删除了每本书只有一个作者

/books/id/author POST

这让我感到困惑，因为 POST 通常意味着创建。在已经设置作者的情况下，api 的用户可能认为他们只是在创建新作者，而实际上他们正在删除旧作者并将其替换为新作者。

剩下的就是

/books/id/author PUT

意思是更新那本书的作者资源。更有意义。但是第一次没有作者怎么办？不是真正的更新而是初始创建？也许只是考虑它是更新一个零作者。

这甚至应该是子资源吗？这将是一个复杂的对象，所以有点道理。虽然我猜你不能没有作者的书。所以我不应该建模为子资源并说您在创建或修改图书资源时传递了作者对象。

最后的想法。我认为我不会将作者建模为根资源。所以至少在这种情况下，它们只会永远存在于书籍资源下。每本书只有一位作者。

Answer 1

But what about the first time when no author exist? Not really an update but the initial create?

使用 PUT/books/id/author 最初创建作者对我来说很好。由于您可以使用 PUT/books/client-supplied-id 创建一本带有客户端提供的 ID 的书，因此您可以创建一本书的作者，该书的作者由已知路径段 作者。

既然您写道作者只会作为一本书的一个组成部分存在，那么这个 URL 方案就可以了。