API接口，`POST`、`PUT`、`GET` 和 `DELETE`有什么区别，怎么用？

在编写API接口时，POST、PUT、GET 和 DELETE 是最常用的HTTP方法，每个方法都有其特定的用途和使用场景。下面是它们的定义、特点、使用场景及示例用法。

1. GET

定义：

GET 方法用于从服务器获取数据。它是安全且幂等的，意味着对同一资源的多个请求不会对资源状态产生任何副作用。

特点：

• 安全性：调用 GET 方法不会修改服务器上的资源。
• 幂等性：多次调用 GET 不会改变资源状态，每次请求返回的结果是相同的。
• 参数传递：GET 请求的参数通过URL的查询字符串传递。

使用场景：

• 获取资源列表，如获取用户列表。
• 获取单个资源，如获取某个用户的详细信息。

示例用法：

// 获取用户列表
GET /users

// 获取指定ID的用户详情
GET /users/{id}

2. POST

定义：

POST 方法用于向服务器发送数据以创建新的资源。它不具备幂等性，即多次调用可能会产生不同的结果。

特点：

• 非幂等性：多次调用 POST 可能会创建多个资源，导致资源状态发生变化。
• 请求体：POST 的数据通常包含在请求体中，用于提交表单数据或上传文件。

使用场景：

• 创建新资源，如创建新用户。
• 提交复杂的数据进行处理，如提交表单或上传文件。

示例用法：

// 创建新用户
POST /users
{
  "username": "newuser",
  "email": "newuser@example.com"
}

3. PUT

定义：

PUT 方法用于更新服务器上的资源。如果资源不存在，可以选择创建或不创建资源。通常用来替换目标资源的整个内容。

特点：

• 幂等性：多次调用 PUT 将产生相同的结果，即资源的最终状态是一样的。
• 全量更新：一般 PUT 是对资源的全量更新。

使用场景：

• 更新已有资源，如更新用户信息。
• 创建资源时需要指定资源的唯一标识符，如上传文件并指定文件ID。

示例用法：

// 更新指定ID的用户信息
PUT /users/{id}
{
  "username": "updateduser",
  "email": "updateduser@example.com"
}

4. DELETE

定义：

DELETE 方法用于删除服务器上的资源。它通常是幂等的，即多次调用不会产生额外影响。

特点：

• 幂等性：调用 DELETE 方法多次不会导致错误，资源删除后再删除不会产生额外影响。
• 不可逆：删除操作通常是不可逆的，删除后资源将不再可用。

使用场景：

• 删除资源，如删除用户或文件。

示例用法：

// 删除指定ID的用户
DELETE /users/{id}

对比与选择

• GET：用于读取数据，适合查询操作。
• POST：用于创建新数据，适合提交表单或创建资源。
• PUT：用于更新数据，适合完整替换资源。
• DELETE：用于删除数据，适合删除操作。

在使用时，根据实际需求选择合适的方法。例如，创建新用户时使用 POST，查询用户时使用 GET，更新用户信息时使用 PUT，删除用户时使用 DELETE。

仅为个人知识分享及开发中遇到的问题总结，
希望对你有所帮助，若有问题欢迎指正~😊