rest api如何创建_REST：创建资源

阳光穿透心脏的1/2处 2023-02-25 03:52 17阅读 0赞

rest api如何创建

资源创建是常见的REST API操作。 在这篇文章中，我们将看到如何创建单个资源。

## 客户要求 ##

通常，通过将POST请求发送到父集合资源来创建资源。 这将使用新生成的ID创建一个新的下属资源。

例如，对*/ projects*的POST请求可用于在*/ projects / 123*处创建新的项目资源。

POST是幂等的，因此，如果多次发出同一请求，则可以创建多个资源。 （如果您不知道什么是幂等，请查看我有关[幂等和安全的文章][Link 1] ）。

在极少数情况下，如果客户端能够生成资源ID，则也有可能使用PUT进行资源创建。 例如，在这种情况下，我们可以使用PUT */ projects / <id>*创建一个新项目。

客户端还必须发送以下标头：

*  用于指定请求主体的[媒体类型][Link 2]的*Content-Type*
 *  *接受*以定义支持的响应格式。 即使服务器不返回新创建的资源，也应发送此标头。 如果资源创建失败，它允许服务器发送详细的错误信息。

范例要求

POST /projects  Content-Type: application/json  Accept: application/json  { 
         "name" : "My cool project" , 
         "description" : "Bla bla .."  }

## 服务器响应 ##

成功创建资源后，服务器应使用HTTP 201（已创建）进行响应。 响应还应该具有一个*Location*标头，其中包含新创建的资源的URI。 需要时，响应主体可以包含创建的资源。 在这种情况下，还需要*Content-Type*标头。

回应范例

HTTP/ 1.1 201 Created  Location: /projects/ 123  Content-Type: application/json  { 
         "id" : 123 , 
         "name" : "My cool project" , 
         "description" : "Bla bla .."  }

> 翻译自: [https://www.javacodegeeks.com/2020/07/rest-creating-resources.html][https_www.javacodegeeks.com_2020_07_rest-creating-resources.html]

rest api如何创建

[Link 1]: https://www.mscharhag.com/api-design/http-idempotent-safe
[Link 2]: https://en.wikipedia.org/wiki/Media_type
[https_www.javacodegeeks.com_2020_07_rest-creating-resources.html]: https://www.javacodegeeks.com/2020/07/rest-creating-resources.html