REST API：HTTP 方法（PUT、DELETE、POST、GET）的重要性

在 RESTful API 领域，一个基本的问题出现了：为什么要使用多种 HTTP 请求类型，例如 PUT、DELETE、POST 和 GET？重要的是要了解 REST 的目的不仅仅是使用最简单的方法访问数据。

REST 的角色

“表征状态转移”(REST)架构提供了一种有意义的与数据交互的方式。发出 REST 请求时，应立即传达要执行的预期操作。

示例：GET 请求

考虑以下 REST 端点：

GET: /cars/make/chevrolet

此端点可能返回雪佛兰汽车列表。通过使用 GET 请求，用户明确指定他们想要检索数据，而不是修改数据。

POST 请求：创建数据

用于创建新数据，通常使用 POST 请求。例如：

POST: /cars/
{ make:chevrolet, model:malibu, colors:[red, green, blue, grey] }

此 POST 请求发送数据以创建具有指定颜色的新雪佛兰 Malibu。 API 不一定与底层数据库结构绑定，而是提供一个屏蔽接口来保护真实数据。

幂等性和 HTTP 方法

HTTP 方法，如 GET 、PUT、DELETE遵循幂等性原则。这意味着重复调用这些方法应该会导致相同的服务器状态。另一方面，POST 通常被认为是非幂等的，因为它可能导致不同的服务器状态。

实现幂等性

为了确保 POST 请求的幂等性，考虑使用以下模式：

POST: /cars/oldest?action=delete

此端点显式定义要执行的操作（删除），使其具有幂等性。相反，像这样的请求：

Delete: /cars/oldest

可能是不明确且非幂等的。

总而言之，在REST API 不是任意的。它们用于传达预期的操作（创建、读取、更新、删除）并确保系统的幂等性。通过遵守这些约定，REST API 提供了一种有意义且结构化的数据操作和交互方法。