Код состояния HTTP 201 Created успешного ответа указывает, что HTTP-запрос привёл к созданию ресурса. Этот код состояния обычно отправляется в ответ на запрос POST.

Новый ресурс либо его описание и ссылка на него создаются до отправки ответа. Созданные элементы могут быть возвращены в теле сообщения ответа, но должны быть доступны по URL исходного запроса или по URL, указанному в значении заголовка Location, переданного вместе с ответом.

Статус

201 Created

Примеры

Получение ответа, указывающего на создание пользователя

Предположим, что существует REST API для управления пользователями с конечной точкой http://example.com/users. В этом примере мы отправляем запрос POST со следующим телом, чтобы создать пользователя:

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

{
  "firstName": "Brian",
  "lastName": "Smith",
  "email": "brian.smith@example.com"
}

После успешного создания пользователя ответ 201 Created будет выглядеть так:

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-запросов
• Коды состояния HTTP-ответов