api - 用于添加到 RESTful API 中的集合的 HTTP 方法

Question

我有一个代表标签集合的资源:

/users/{username}/tags

API 客户端应该能够在单个 HTTP 请求中向该集合添加一组标签。我考虑过如何做到这一点，首先考虑使用 PUT 或 POST 方法。但是我认为这意味着客户端正在“设置”或“替换”该集合中的标签。将多个标签“添加”到该集合的最合适的 HTTP 方法(或者可能是不同的机制)是什么？

{HTTP METHOD} /users/{username}/tags

请求正文:

 ["short", "crazy", "funny"]

Answer 1

PUT /users/alganet/tags替换所有标签。
POST /users/alganet/tags添加更多标签。

您也可以使用 PATCH .
PATCH /users/alganet/tags更改标签。

可能的 body :
{"POST":["rest", "php"], "DELETE":["soap"]}
正文必须具有与 Accept-Patch 匹配的特定补丁格式标题。上面的示例正文是补丁的自定义格式，但您可以使用干净的 diff例如。