201 已创建

HTTP **201 已创建** 成功响应 状态码表示 HTTP 请求导致创建了一个资源。此状态码通常作为 POST 请求的结果发送。

新资源或对新资源的描述和链接在返回响应之前创建。新创建的项目在消息正文中返回,位于初始请求的 URL 或响应中 Location 标头值的 URL 中。

状态

http
201 Created

示例

接收指示用户创建的响应

假设有一个用于管理用户的 REST API,其端点位于 http://example.com/users。在此示例中,我们发送一个带有以下正文的 POST 请求以创建用户

http
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json

{
  "firstName": "Brian",
  "lastName": "Smith",
  "email": "[email protected]"
}

用户成功创建后,201 已创建 响应将如下所示

http
HTTP/1.1 201 Created
Content-Type: application/json
Location: http://example.com/users/123

{
  "message": "New user created",
  "user": {
    "id": 123,
    "firstName": "Brian",
    "lastName": "Smith",
    "email": "[email protected]"
  }
}

规范

规范
HTTP 语义
# status.201

另请参阅