单个API端点POST与PUT的使用困惑及DELETE操作疑问

1. 完全替换帖子内容：用PUT还是POST？ #

• 要完全替换/posts/{id}对应的整个帖子资源（比如一次性更新title、author、body所有字段，覆盖原有内容），标准做法用PUT。PUT的语义就是“替换目标资源的全部内容”，请求体里得包含该资源的完整数据。
• 如果只是更新部分字段，优先用PATCH；要是API没实现PATCH，也有用POST的，但POST的语义更偏向“对资源执行一个自定义操作”，不是标准的全量替换动作。

2. POST请求到/posts/{id}是否合理？ #

合理，但得看场景。POST本身没有严格的语义限制，它可以用来执行任何不属于GET/PUT/PATCH/DELETE标准语义的操作：

• 比如对帖子执行特定动作（触发审核、添加评论），这时候POST到/posts/{id}/approve或/posts/{id}/comments更清晰，但如果API设计简化，也可以用POST到/posts/{id}，通过请求体参数指定操作类型。
• 但要是用POST来做全量替换资源，就不符合REST的语义规范，远不如PUT清晰直观。

3. POST等同于SQL的INSERT，PUT等同于UPDATE？ #

完全不是，这是很常见的误解：

• HTTP方法的语义和SQL操作没有直接对应关系：
  • PUT可以用来创建资源（比如你提前知道资源ID，直接PUT到/posts/123，如果该ID不存在就创建），这时候对应的是SQL的INSERT。
  • POST也可以用来更新资源（比如部分更新、执行特定操作），不一定就是INSERT。
  • 核心区别是：PUT是幂等的（多次执行结果完全一样），POST是非幂等的（多次执行可能产生不同结果，比如重复创建评论）。

4. DELETE /posts/{id}/tags会删除所有标签还是单个标签？ #

这完全取决于API的设计：

• 如果/posts/{id}/tags代表该帖子的所有标签集合，那么DELETE这个路径通常会删除该帖子的全部标签。
• 要是想删除单个标签，标准设计应该是DELETE /posts/{id}/tags/{tagId}，或者DELETE /posts/{id}/tags?name=xxx，明确指定要删除的单个标签。
• 所以具体行为得看API文档的定义，但从REST语义的常规设计来说，DELETE集合路径就是删除整个集合。

内容的提问来源于stack exchange，提问作者David542