rest - 使用 Http Post 发送状态数据是一种好习惯吗？

Question

我知道 post 通常用来告诉网络服务器存储东西，如果我只想发送一些状态数据，正确的方法是什么？比如说，我要发布客户状态？

Answer 1

如果要更新现有资源的状态，必须使用PUT 方法。但后者对应于整个状态的更新，即你需要发送所有字段。如果你想做一个部分更新，你应该考虑 PATCH 一个。您可以仅发送字段或利用 JSON Patch格式。

这里有一些例子:

• 完整更新:

    PUT /someresource/someid
    Content-Type: application/json
    {
      (...)
      "status": "some status"
    }
  

• 部分更新:

    PATCH /someresource/someid
    Content-Type: application/json
    {
      "status": "some status"
    }
  
    204 No content
  

• 使用 JSON 补丁进行部分更新:

    PATCH /someresource/someid
    Content-Type: application/json
    [
      {
        "op": "replace",
        "path": "/status",
        "value": "some status"
      }
    ]
  
    204 No content
  

如果“发送一些状态数据”对应于在你的数据存储中添加一些东西，你应该考虑使用 POST 方法但是在列表资源上(单个资源用于 PUT 和 PATCH 用于特定资源元素)。这是一个示例:

    PUT /someresource/
    Content-Type: application/json
    {
      (...)
      "status": "some status"
    }

    204 No content
    Location: http://.../someresource/newid

以下是一些可以帮助您的附加链接:

• 设计 Web API(即 RESTful 服务):http://restlet.com/blog/2015/03/16/designing-a-web-api/
• 不要像白痴一样打补丁:http://williamdurand.fr/2014/02/14/please-do-not-patch-like-an-idiot/

希望对你有帮助，蒂埃里