Что означает HTTP-код состояния 201?

Ответ

Код состояния 201 (Created) означает, что запрос выполнен успешно и в результате был создан новый ресурс на сервере. Это стандартный ответ для успешных POST-запросов в RESTful API.

Ключевые особенности:

  • Сервер подтверждает создание ресурса.
  • В заголовке ответа Location часто указывается URI созданного ресурса.
  • Тело ответа обычно содержит представление созданного объекта.

Пример HTTP-ответа:

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

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

Почему это важно: Клиент может использовать URI из заголовка Location для последующих операций (GET, PUT, DELETE) с новым ресурсом.

Ответ 18+ 🔞

А, ну это же про тот самый код, когда всё получилось, но не просто так, а с бонусом! Представь, ты отправил на сервер какую-то хуйню — нового пользователя, пост в блог, кота в мешке. И сервер тебе такой: «Э, сабака сука, принято! Не просто принято, а я ещё и создал эту хуйню у себя в базе, вот тебе её новый адресок».

Код 201 (Created) — это как пиздатый ответ на POST-запрос. Не просто «окей», а «окей, мудила, я сделал новую сущность, держи ссылку на неё».

Что тут важно, блядь:

  • Сервер не просто кивает, а реально подтверждает: «Да, чувак, ресурс создан, можешь не бздеть».
  • В заголовках ответа, в Location, почти всегда будет ссылка на эту новую хуйню. Это как адрес только что построенной халупы.
  • А в теле ответа тебе обычно скидывают и само созданное говно в JSON или XML, чтобы ты сразу видел, какой id ему присвоили и что там внутри.

Вот как это выглядит вживую, ёпта:

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

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

И в чём соль, блядь? Клиенту теперь не надо гадать, где искать только что созданного юзера. Берёшь этот самый Location из заголовка — /api/users/123 — и можешь сразу его хуярить: смотреть, обновлять или нахуй удалять. Удобно же, в рот меня чих-пых!