更新对象标签的最佳API调用方式选择问题

首先纠正一个常见的认知误区：REST API 的 HTTP 方法语义是针对对外暴露的资源状态操作定义的，和服务端内部数据库执行的具体操作类型无关。

针对你描述的场景（客户端发送某video_id对应的完整新标签列表，服务端将该视频的标签集合全量替换为新列表），PUT是完全符合REST规范的最优选择，原因如下：

• PUT的核心语义是「用客户端提交的完整资源表示，完全替换目标资源的当前状态」，你可以将/videos/{video_id}/tags作为独立资源，该资源的内容就是指定视频的全部标签数组，客户端提交新的标签数组后，服务端侧该资源的最终状态和客户端提交的内容完全一致，完全匹配PUT的语义。
• PUT天然满足幂等性：同一请求调用1次和调用N次的最终效果完全一致，和你当前操作的特性匹配，降低重试等异常场景的处理成本。

其他可选方法的适配性说明：

• POST：仅适合给视频新增单个标签、或者提交标签做非幂等的处理逻辑，全量替换场景下用POST不符合语义，也浪费了幂等性的特性。
• PATCH：仅适合标签的增量更新场景，比如客户端只提交需要新增/删除的标签，不需要发送全量标签列表，才需要用PATCH，当前全量替换的场景用PATCH反而不符合语义。

如果后续需要扩展增量更新标签的能力，可以同时保留两套接口做区分：

• 全量替换标签：PUT /videos/{video_id}/tags，请求体为完整的标签数组
• 增量更新标签：PATCH /videos/{video_id}/tags，请求体为操作描述，示例结构如下：

{
  "add": ["科普", "数码"],
  "remove": ["旧标签1", "旧标签2"]
}

内容的提问来源于stack exchange，提问作者The Blind Hawk