Ответ
HTTP 201 Created — код успешного статуса, который указывает, что запрос (обычно POST или PUT) выполнен успешно и в результате был создан новый ресурс на сервере.
Когда используется:
- Успешное создание пользователя через
POST /api/users. - Загрузка нового файла.
- Создание записи в базе данных через RESTful API.
Обязательный и рекомендуемый заголовок ответа:
Location— URI вновь созданного ресурса. Клиент может использовать эту ссылку для последующих запросов.
Пример успешного ответа:
POST /api/articles HTTP/1.1
Host: example.com
Content-Type: application/json
{"title": "Новая статья", "content": "Текст..."}
HTTP/1.1 201 Created
Location: /api/articles/789
Content-Type: application/json
{"id": 789, "title": "Новая статья", "status": "created"}Этот статус более конкретен, чем общий 200 OK, и явно сообщает клиенту о факте создания.