REST - HTTP DELETE - 语义 - 只删除后代

Question

在我们的项目中，可以通过 REST 检索所有书籍的列表:

GET http://server/api/books/

可以按如下方式检索特定书籍:

GET http://server/api/books/:id/

删除特定书籍很容易:

DELETE http://server/api/books/:id/

现在，我的问题是:以下调用的结果应该是什么:

DELETE http://server/api/books/

很明显，所有的书都被删除了。但是资源 books/ 是否也应该被删除？即请求后:

1. GET/books/应该返回 200 OK 和一个空列表吗？或
2. 是否应该 GET/books/返回 404 not found？

根据规范，具体的 URI 将在之后消失，我会选择第二个选项。然而，在我看来，这会使事情变得复杂和不合逻辑。有一个空书单比没有书更有意义。

你怎么看？

Answer 1

如果这让您感觉更好，请假设服务器具有在图书资源被删除后自动重新创建图书资源的逻辑。 :-)

我会选择 200 OK 和一个空列表。如果您真的不喜欢那样，请创建一个名为 /books/all

的新资源

做

DELETE /Books/all