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 |