201 Created ("создано")

Описание

Код состояния 201 Created указывает, что запрос был успешно выполнен и в результате был создан новый ресурс.

Основные характеристики:

• Используется в ответ на POST или другие методы, создающие ресурс
• Сервер создаёт ресурс до отправки ответа
• Ответ может содержать данные нового ресурса или ссылку на него

Типичное использование:

POST /api/users HTTP/1.1
Content-Type: application/json

{
    "name": "John Doe",
    "email": "john@example.com"
}

HTTP/1.1 201 Created
Location: /api/users/123
Content-Type: application/json

{
    "id": 123,
    "name": "John Doe",
    "email": "john@example.com"
}

Особенности заголовков:

• Location — указывает URL созданного ресурса
• Content-Type — формат тела ответа, если оно присутствует

Когда использовать:

1. После успешного POST-запроса, создавшего новый объект
2. В REST API при добавлении записи (пользователя, товара, сообщения и т.п.)
3. Когда нужно сообщить клиенту ID, URL или тело нового ресурса

Дополнительно:

• Если ресурс не создаётся, следует использовать 200 OK или 204 No Content
• Сервер должен гарантировать, что ресурс был создан **однократно**, даже при повторной отправке запроса
• Поддержка заголовка Location особенно важна для клиентоориентированных API

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/201

Похожие статусы

200

хорошо

202

принято

204

нет содержимого