我们可以使用 POST request 而不是 PUT 来创建资源

在 RESTful API 设计中，创建一个新的资源应该使用 HTTP 方法中的 POST 或 PUT 请求。但是，很多程序员都不知道应该在什么情况下使用 POST 请求，而不是 PUT 请求。在本文中，我们将详细介绍什么时候应该使用 POST 请求，而不是 PUT 请求，以及为什么这样做能够提升 API 的可读性和可维护性。

什么是 POST 请求？

HTTP Post 请求通常用于将数据提交到服务器以创建或更新资源。与 GET 请求不同，POST 请求可以在请求主体中传递数据，而 GET 请求只能在 URL 中传递数据。另外，POST 请求是一个非幂等的请求，即在多次使用同样的数据进行 POST 请求时，每一次请求的结果可能会不同。

什么是 PUT 请求？

PUT 请求通常用于将数据提交到服务器以更新或创建资源。与 POST 请求不同，PUT 请求通常被认为是幂等的，即无论进行多少次请求，结果都应该是相同的。PUT 请求的主要目的是将指定的资源的状态替换为请求中提供的状态。

何时使用 POST 而不是 PUT？

在 RESTful API 设计中，POST 请求通常用于创建新的资源，而 PUT 请求通常用于更新现有资源。但是，这并不是绝对的。在某些情况下，使用 POST 请求而不是 PUT 请求来创建新的资源可能是更好的选择。

当资源标识符未知时

如果客户端无法确定要创建的新资源的标识符，那么使用 POST 请求来创建资源通常是更好的选择。在这种情况下，服务器可以分配一个新的标识符，并将其与新创建的资源相关联。使用 PUT 请求时，客户端必须提供资源的标识符。如果客户端无法提供标识符，那么使用 PUT 请求来创建资源将是不可能的。

当资源具有不可更改的属性时

如果新创建的资源具有某些不可更改的属性（例如创建日期或ID），那么使用 POST 请求来创建资源可能是更好的选择。在这种情况下，服务器可以自动分配这些属性的值，并将其与新创建的资源相关联。如果使用 PUT 请求来创建资源，则可能会出现客户端尝试更改这些不可更改属性的情况。

当请求能够返回更多信息时

使用 POST 请求时，服务器可以返回比使用 PUT 请求时更多的信息，例如新创建的资源的标识符或其他元数据。这些信息可能对客户端非常有用，因此使用 POST 请求可以提高 API 的可读性和可维护性。

结论

总的来说，使用 POST 请求而不是 PUT 请求来创建新的资源通常是一个更好的选择。虽然 PUT 请求是幂等的，但是 POST 请求更加灵活，适用于更多的情况。此外，使用 POST 请求可以提高 API 的可读性和可维护性，因为它允许服务器返回更多有用的信息。在设计 RESTful API 时，应该考虑这些因素，选择正确的 HTTP 方法来创建和更新资源。

# 我们可以使用 POST request 而不是 PUT 来创建资源

在 RESTful API 设计中，创建一个新的资源应该使用 HTTP 方法中的 POST 或 PUT 请求。但是，很多程序员都不知道应该在什么情况下使用 POST 请求，而不是 PUT 请求。在本文中，我们将详细介绍什么时候应该使用 POST 请求，而不是 PUT 请求，以及为什么这样做能够提升 API 的可读性和可维护性。

## 什么是 POST 请求？

HTTP Post 请求通常用于将数据提交到服务器以创建或更新资源。与 GET 请求不同，POST 请求可以在请求主体中传递数据，而 GET 请求只能在 URL 中传递数据。另外，POST 请求是一个非幂等的请求，即在多次使用同样的数据进行 POST 请求时，每一次请求的结果可能会不同。

## 什么是 PUT 请求？

PUT 请求通常用于将数据提交到服务器以更新或创建资源。与 POST 请求不同，PUT 请求通常被认为是幂等的，即无论进行多少次请求，结果都应该是相同的。PUT 请求的主要目的是将指定的资源的状态替换为请求中提供的状态。

## 何时使用 POST 而不是 PUT？

在 RESTful API 设计中，POST 请求通常用于创建新的资源，而 PUT 请求通常用于更新现有资源。但是，这并不是绝对的。在某些情况下，使用 POST 请求而不是 PUT 请求来创建新的资源可能是更好的选择。

### 当资源标识符未知时

如果客户端无法确定要创建的新资源的标识符，那么使用 POST 请求来创建资源通常是更好的选择。在这种情况下，服务器可以分配一个新的标识符，并将其与新创建的资源相关联。使用 PUT 请求时，客户端必须提供资源的标识符。如果客户端无法提供标识符，那么使用 PUT 请求来创建资源将是不可能的。

### 当资源具有不可更改的属性时

如果新创建的资源具有某些不可更改的属性（例如创建日期或ID），那么使用 POST 请求来创建资源可能是更好的选择。在这种情况下，服务器可以自动分配这些属性的值，并将其与新创建的资源相关联。如果使用 PUT 请求来创建资源，则可能会出现客户端尝试更改这些不可更改属性的情况。

### 当请求能够返回更多信息时

使用 POST 请求时，服务器可以返回比使用 PUT 请求时更多的信息，例如新创建的资源的标识符或其他元数据。这些信息可能对客户端非常有用，因此使用 POST 请求可以提高 API 的可读性和可维护性。

## 结论

总的来说，使用 POST 请求而不是 PUT 请求来创建新的资源通常是一个更好的选择。虽然 PUT 请求是幂等的，但是 POST 请求更加灵活，适用于更多的情况。此外，使用 POST 请求可以提高 API 的可读性和可维护性，因为它允许服务器返回更多有用的信息。在设计 RESTful API 时，应该考虑这些因素，选择正确的 HTTP 方法来创建和更新资源。