Какой HTTP-статус-код должен возвращать сервер при успешном создании ресурса через POST-запрос?

HTTP-статус-код 201 Created

При успешном создании ресурса через POST-запрос сервер должен возвращать статус-код 201 Created. Этот код является частью стандарта HTTP/1.1 и явно указывает, что запрос был выполнен успешно, и в результате на сервере был создан новый ресурс.

Почему именно 201, а не 200?

Хотя код 200 OK также означает успех, он не передает информацию о создании нового ресурса. Использование 201 Created делает API более семантичным и предсказуемым для клиентов. Это особенно важно в REST-архитектуре, где каждый статус-код имеет четкое значение.

Практический пример

Рассмотрим создание пользователя через 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 созданного ресурса для удобства клиента.
• Возвращайте тело ответа с представлением созданного ресурса, если это уместно.
• Для асинхронных операций, где ресурс создается не сразу, можно использовать 202 Accepted.

Вывод: Используйте 201 Created для POST-запросов, создающих новые ресурсы, чтобы сделать API более понятным и соответствующим стандартам REST.