201 Created
HTTP 201 Created 成功响应状态码表示 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": "brian.smith@example.com"
}
用户成功创建后，201 Created 响应将如下所示
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": "brian.smith@example.com"
}
}
规范
| 规范 |
|---|
| HTTP 语义 # status.201 |