删除一堆项目的宁静方式

Question

在wiki article for REST 表示如果您使用http://example.com/resourcesDELETE，则表示您正在删除整个集合。

如果您使用http://example.com/resources/7HOU57YDELETE，则表示您正在删除该元素。

我正在做一个网站，注意不是网络服务。

我有一个列表，列表中的每个项目都有 1 个复选框。一旦我选择了多个要删除的项目，我将允许用户按下一个名为 DELETE SELECTION 的按钮。如果用户按下按钮，会弹出一个 js 对话框，要求用户确认删除。如果用户确认，则删除所有项目。

那么我应该如何满足以 RESTFUL 方式删除多个项目？

注意，目前对于网页中的 DELETE，我所做的是我使用 FORM 标记和 POST 作为操作，但包含一个 _method，其值为 DELETE，因为this is what was indicated by others in SO on how to do RESTful delete for webpage。

Answer 1

我认为rojoca's answer 是迄今为止最好的。一个细微的变化可能是，取消同一页面上的 javascript 确认，而是创建选择并重定向到它，在该页面上显示确认消息。换句话说：

发件人：
http://example.com/resources/

做一个

选择 ID 后发送至：
http://example.com/resources/selections

如果成功，应该回复：

已创建 HTTP/1.1 201，并将 Location 标头发送到：
http://example.com/resources/selections/DF4XY7

在此页面上，您将看到一个 (javascript) 确认框，如果您确认，它将执行以下请求：

删除http://example.com/resources/selections/DF4XY7

如果成功，应该回复： HTTP/1.1 200 Ok（或任何适合成功删除的内容）

Answer 2

一种选择是创建删除“事务”。所以你 POST 到 http://example.com/resources/deletes 这样的新资源，其中包含要删除的资源列表。然后在您的应用程序中，您只需执行删除。当您发布帖子时，您应该返回您创建的交易的位置，例如http://example.com/resources/deletes/DF4XY7。对此的GET 可以返回事务的状态（完成或正在进行）和/或要删除的资源列表。

Answer 3

这是 Amazon 使用 S3 REST API 所做的。

个别删除请求：

DELETE /ObjectName HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Content-Length: length
Authorization: authorization string (see Authenticating Requests (AWS Signature Version 4))

Multi-Object Delete 请求：

POST /?delete HTTP/1.1
Host: bucketname.s3.amazonaws.com
Authorization: authorization string
Content-Length: Size
Content-MD5: MD5

<?xml version="1.0" encoding="UTF-8"?>
<Delete>
    <Quiet>true</Quiet>
    <Object>
         <Key>Key</Key>
         <VersionId>VersionId</VersionId>
    </Object>
    <Object>
         <Key>Key</Key>
    </Object>
    ...
</Delete>           

但Facebook Graph API、Parse Server REST API 和Google Drive REST API 更进一步，让您能够在一个请求中“批处理”单个操作。

这是 Parse Server 的一个示例。

个别删除请求：

curl -X DELETE \
  -H "X-Parse-Application-Id: ${APPLICATION_ID}" \
  -H "X-Parse-REST-API-Key: ${REST_API_KEY}" \
  https://api.parse.com/1/classes/GameScore/Ed1nuqPvcm

批量请求：

curl -X POST \
  -H "X-Parse-Application-Id: ${APPLICATION_ID}" \
  -H "X-Parse-REST-API-Key: ${REST_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
        "requests": [
          {
            "method": "POST",
            "path": "/1/classes/GameScore",
            "body": {
              "score": 1337,
              "playerName": "Sean Plott"
            }
          },
          {
            "method": "POST",
            "path": "/1/classes/GameScore",
            "body": {
              "score": 1338,
              "playerName": "ZeroCool"
            }
          }
        ]
      }' \
  https://api.parse.com/1/batch

Answer 4

有趣的是，我认为相同的方法适用于修补多个实体，并且需要考虑我们对 URL、参数和 REST 方法的含义。

1. 返回所有 'foo' 元素：

   [GET] api/foo

2. 返回 'foo' 元素并过滤特定 ID：

   [GET] api/foo?ids=3,5,9

什么意思是 URL 和过滤器确定“我们正在处理哪些元素？”，而 REST 方法（在本例中为“GET”）表示“如何处理这些元素？”

1. 因此 PATCH 多条记录以将它们标记为已读

   [PATCH] api/foo?ids=3,5,9

..with 数据 foo[read]=1

1. 最后要删除多条记录，这个端点是最合乎逻辑的：

   [DELETE] api/foo?ids=3,5,9

请理解我不相信这有任何“规则” - 对我来说它只是“有意义”

Answer 5

我会说删除http://example.com/resources/id1,id2,id3,id4 或删除http://example.com/resources/id1+id2+id3+id4。由于“REST 是一种架构（...）[不是]协议”引用这篇维基百科文章，我相信没有单一的方法可以做到这一点。

我知道如果没有带有 HTML 的 JS，以上是不可能的，但我觉得 REST 是：

• 创建时没有考虑交易等次要细节。谁需要对单个项目进行操作？这在 HTTP 协议中是合理的，因为它不打算通过它提供除静态网页之外的任何其他内容。
• 没有必要很好地适应当前模型 - 即使是纯 HTML。

Answer 6

正如Decent Dabbler answer 和rojocas answer 所说，最规范的是使用虚拟资源来删除资源选择，但我认为从 REST 角度来看这是不正确的，因为执行 DELETE http://example.com/resources/selections/DF4XY7 应该删除选择资源本身，而不是选定的资源。

以Maciej Piechotka anwser 或fezfox answer 为例，我只有一个反对意见：有一种更规范的方式来传递一个id 数组，并且是使用数组运算符：

DELETE /api/resources?ids[]=1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d&ids[]=7e8f9a0b-1c2d-3e4f-5a6b-7c8d9e0f1a2b

通过这种方式，您正在攻击删除集合端点，但以正确的方式使用查询字符串过滤删除。

Answer 7

由于没有“正确”的方法来做到这一点，我过去所做的是：

将 DELETE 发送到 http://example.com/something，正文中包含 xml 或 json 编码数据。

当您收到请求时，请检查 DELETE，如果为 true，则阅读正文以查找要删除的内容。

Answer 8

我有同样的情况删除多个项目。这就是我最终做的。我使用了 DELETE 操作，要删除的项目的 ID 是 HTTP 标头的一部分。