API端点用于单个项目--POST vs PUT
API端点用于单个项目--POST vs PUT
让我们来看下面的API：\n![\"enter](\"https://i.stack.imgur.com/wCZC0.png\"/)
\n我总是有点不清楚的是在更新 /posts/{id} 项时会发生什么。如果一个帖子包含：\n
- \n
- ID
- 标题
- 作者
- 发布时间
- 内容
\n
\n
\n
\n
\n
\n如果我们想要清除以前的帖子并用新帖子更新它（也就是说，类似于 getByID.update(title, author, body) -- 这应该通过 PUT 请求还是 POST 请求来完成？是否有意义将 POST 请求发送到 /posts/{id} 或者只有 PUT 请求才能更新现有记录，即 POST 类似于 SQL 中的 INSERT，PUT 类似于 SQL 中的 UPDATE。\n此外，如果存在类似于列表字段的东西会怎么样？例如，/posts/{id}/tags，其中标签可以是像 programming、c++、rest 这样的内容。如果有人在这里执行 delete 操作，是删除所有的标签还是只删除一个标签？
在设计REST API时，我们经常需要为单个项目创建一个API端点。然而，在创建这个API端点时，我们面临一个问题：应该使用POST还是PUT方法？
POST方法通常用于创建新的资源。当我们使用POST方法时，我们将向服务器发送一个请求，请求服务器创建一个新的项目。因此，如果我们要创建一个新的项目，那么POST方法是最合适的选择。
然而，有时我们可能需要对已存在的项目进行更新。在这种情况下，我们可以使用PUT方法。PUT方法是用于完整替换资源的，即我们需要将整个项目更新为新的内容。
那么，为什么我们不能使用PUT方法来创建新的项目呢？原因是PUT方法用于完整替换资源，如果我们使用PUT方法来创建新的项目，那么我们必须提供所有字段的值，即使一些字段是可选的。这可能会导致一些字段被错误地设置为null或空值。因此，使用PUT方法来创建新的项目可能会引发一些问题。
解决这个问题的方法是使用POST方法来创建新的项目，并使用PATCH方法进行部分更新。PATCH方法允许我们仅更新项目的部分字段，而不是替换整个项目。这样，我们可以避免使用PUT方法时可能引发的问题。
总结起来，当我们需要为单个项目创建API端点时，应该使用POST方法来创建新的项目。如果我们需要对已存在的项目进行更新，应该使用PATCH方法进行部分更新。如果其他字段是只读的，也可以使用PUT方法进行完整替换。这样，我们可以更好地设计和使用REST API。
问题的出现原因是：在进行单个项目的API端点时，需要确定是使用POST还是PUT方法。POST方法用于在服务器确定位置（ID）的情况下创建新项目，响应中应包含一个Location头告诉客户端对象的最终位置（POST-redirect-GET模式）。而PUT方法用于在客户端定义的位置创建新项目（如果允许），或替换给定位置的项目（包括“更新”，其中客户端发送的主体是对象的完整表示，就像从GET获取的一样）。而PATCH方法用于对给定位置的项目进行就地部分更新。
要解决这个问题，可以根据具体需求来决定使用POST还是PUT方法。如果需要服务器确定位置，可以使用POST方法，并在响应中包含Location头。如果允许客户端定义位置，或需要替换给定位置的项目，可以使用PUT方法。而如果只需要对给定位置的项目进行部分更新，可以使用PATCH方法。
下面是一个使用POST-redirect-GET模式的示例：
POST /api/items
Content-Type: application/json
{
"name": "New Item",
"description": "This is a new item"
}
响应中包含了Location头，告诉客户端新对象的位置：
HTTP/1.1 201 Created
Location: /api/items/123
另一个示例是使用PATCH方法进行部分更新：
PATCH /api/items/123
Content-Type: application/json
{
"description": "Updated description"
}
这将对位置为123的项目进行部分更新，只更新description字段。
通过以上示例，我们可以根据具体需求选择合适的方法来处理单个项目的API端点。