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

用于在RESTful API中添加到集合的HTTP方法,api,rest,http-method,Api,Rest,Http Method,我有一个表示标记集合的资源: /users/{username}/tags API客户端应该能够在单个HTTP请求中向该集合添加一组标记。我考虑了如何做到这一点,并首先考虑使用PUT或POST方法。然而,我认为这意味着客户端正在“设置”或“替换”该集合中的标记。向该集合“添加”多个标记的最合适的HTTP方法(或者可能是另一种机制)是什么 {HTTP METHOD} /users/{username}/tags 请求机构: ["short", "crazy", "funny"] 如果请求正

我有一个表示标记集合的资源:

/users/{username}/tags
API客户端应该能够在单个HTTP请求中向该集合添加一组标记。我考虑了如何做到这一点,并首先考虑使用PUT或POST方法。然而,我认为这意味着客户端正在“设置”或“替换”该集合中的标记。向该集合“添加”多个标记的最合适的HTTP方法(或者可能是另一种机制)是什么

{HTTP METHOD} /users/{username}/tags
请求机构:

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

如果请求正文中发送的标签是要添加到集合中,而不是替换,我建议发布。如果要替换现有标记,请使用PUT。

PUT/users/alganet/tags
替换所有标记

POST/users/alganet/tags
添加更多标签

您也可以使用

PATCH/users/alganet/tags
更改标签

可能的机构:

{“POST”:[“rest”,“php”],“DELETE”:[“soap”]}

正文必须具有与
Accept patch
标题匹配的特定补丁格式。上面的示例主体是补丁的自定义格式,但您可以使用干净的
diff