Поиск
Справочник

Код 201 Created: что значит и когда сервер его отправляет

201 Created («создано») — запрос выполнен, и сервер создал что-то новое: запись в базе, файл или папку. Это успешный ответ, а не ошибка: исправлять ничего не нужно. Его присылают API и программы сайтов, когда клиент добавил данные, — например, оформил заказ или загрузил файл.

≈ 23 мин чтения
Содержание 14

Коротко: нужно ли что-то делать

Код 201 — не ошибка. Все коды, которые начинаются с двойки, значат одно: сервер получил запрос, понял его и принял. Выберите свой случай:

  • Увидели 201 в ответе сайта, API или в инструментах разработчика браузера. Делать ничего не нужно: запрос выполнен, и на сервере появилась новая запись или файл. Что именно сообщает этот код — в разделе «Что означает код 201».
  • Нашли 201 в журнале своего сервера. Это след успешного запроса: кто-то добавил запись или загрузил файл. Например, так WordPress отвечает на загрузку картинки в редакторе блоков. Как посмотреть, какие адреса отвечают 201, — в разделе «Откуда 201 в журнале сайта».
  • Ваша программа считает ответ 201 сбоем. По всей видимости, она сравнивает код ровно с числом 200, а успешных кодов больше. Что исправить — в разделе «Чем 201 отличается от 200».
  • Ждали, что после ответа 201 браузер перейдёт на новую страницу, а он остался на месте. Так и должно быть: заголовок Location в ответе 201 — это адрес созданного, а не команда перейти. Подробнее — в разделе «Заголовок Location в ответе 201».
  • Пишете свой API и выбираете код ответа. Вам нужны разделы «Когда отвечать 201, а когда 200, 202 или 204» и «Как отправить 201 из своей программы».

Что означает код 201

Код ответа — трёхзначное число, которым сервер сообщает, чем закончился запрос. Первая цифра задаёт смысл: коды на 2 — успех, на 3 — перенаправление, на 4 — ошибка в запросе, на 5 — ошибка на сервере.

201 Created переводится как «создано». Этим кодом сервер сообщает сразу две вещи: запрос выполнен, и в результате на сервере появилось что-то новое. В стандарте HTTP это новое называется ресурсом. Например:

  • в базе появилась запись о заказе;
  • зарегистрирована учётная запись;
  • на сервер загружен файл;
  • создана папка, заметка или комментарий.

Вот как выглядит обмен целиком. Программа отправляет серверу данные нового заказа:

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

{"name":"test"}

Сервер создаёт заказ и отвечает:

HTTP/1.1 201 Created
Location: /api/orders/125
Content-Type: application/json

{"id":125,"name":"test"}

В первой строке ответа — код 201 и слово Created. В заголовке Location сервер называет адрес созданного: заказ теперь лежит по адресу /api/orders/125. После пустой строки идёт тело ответа — здесь это сам заказ в формате JSON.

Ни заголовок Location, ни тело в ответе 201 не обязательны. Если заголовка Location нет, созданным считается то, что теперь лежит по адресу самого запроса. Если сайт работает по HTTP/2, слова Created в ответе нет: curl покажет первую строку как HTTP/2 201.

Чем 201 отличается от 200

Оба кода значат успех. Разница в том, что произошло на сервере:

Что сравниваем200 OK201 Created
Что значитЗапрос выполненЗапрос выполнен, и создано что-то новое
Когда приходитСервер отдал страницу или данные, изменил существующую записьСервер добавил запись, файл или папку
Заголовок LocationНе используетсяАдрес созданного
Что видит посетитель в браузереТело ответаТело ответа — так же, как при 200
Как считают программыУспехУспех

Проверка в Chrome 157 это подтвердила: получив ответ 201, браузер показал тело ответа — так же, как показал бы страницу с кодом 200.

Программы тоже считают 201 успехом. В JavaScript свойство response.ok равно true для любого кода от 200 до 299 — в той же проверке для ответа 201 оно было true. Команда curl с ключом -f завершается с ошибкой только на кодах 400 и выше; на ответе 201 она завершилась без ошибки.

Ошибка появляется там, где программа сравнивает код ровно с числом 200. Успешный ответ 201 она примет за сбой и, возможно, отправит запрос ещё раз — а сервер может создать вторую такую же запись: второй заказ, второй комментарий. Поэтому сравнивайте код не с одним числом, а со всем диапазоном успешных кодов:

// плохо: успешный ответ 201 попадёт в ошибки
if (response.status === 200) { ... }

// хорошо: успехом считается любой код от 200 до 299
if (response.ok) { ... }

В других языках смысл тот же: успех — это любой код от 200 до 299.

Откуда 201 в журнале сайта

Веб-сервер записывает в журнал каждый запрос вместе с кодом ответа. Чтобы увидеть, какие адреса сайта отвечают 201, подключитесь к серверу по SSH — как это сделать, рассказано в инструкции Как подключиться к VPS по SSH — и выполните команду:

sudo awk '$9 == 201 {print $6, $7}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -20

Это команда для nginx. Если у вас Apache, замените путь на /var/log/apache2/access.log. Команда рассчитана на стандартный формат журнала (combined): в нём код ответа стоит девятым по счёту. Пример результата:

      2 "POST /api/orders/
      1 "PUT /upload/test.txt
      1 "POST /wp-json/wp/v2/media

Слева — сколько раз встретился запрос, дальше — метод и адрес. Кавычка перед методом — часть записи журнала, так и должно быть. Если команда ничего не вывела, ответов 201 в текущем файле журнала нет. Как устроены сами журналы, рассказано на страницах Журналы nginx и Журналы Apache.

Команда рассчитана на свой сервер (VPS). На виртуальном хостинге журнал запросов ищите в панели управления или спросите у поддержки.

Теперь о том, кто отвечает кодом 201.

WordPress. У WordPress есть REST API — адреса, через которые редактор блоков и другие программы обмениваются данными с сайтом. Такой адрес начинается с /wp-json/ или содержит rest_route=. Когда через REST API создаётся запись, страница, медиафайл, комментарий, рубрика, метка или пользователь, WordPress отвечает 201. Пример: вы добавляете в запись картинку с компьютера, редактор блоков отправляет файл на сервер, и в журнале появляется строка POST /wp-json/wp/v2/media с кодом 201. Создавать записи и загружать файлы через REST API может только пользователь, который вошёл на сайт и имеет на это право: запрос без входа получит 401. Комментарии без входа через REST API по умолчанию тоже не принимаются. Плагины добавляют в /wp-json/ свои адреса и сами выбирают код ответа — 201 может прийти и от них.

Laravel. Сам ставит код 201, когда маршрут или контроллер возвращает только что созданную модель, — например, новый заказ.

Свой API или готовая программа. Код выбирает автор программы. По стандарту 201 отправляют, когда запрос создал новую запись.

Сам веб-сервер. Без программы сайта nginx и Apache отвечают 201, когда на сервере включена запись файлов по WebDAV. Об этом раздел «Как 201 отвечает сам веб-сервер: WebDAV».

Если в журнале запрос PUT с кодом 201, а загрузку файлов вы не настраивали

Запрос PUT с кодом 201 значит одно из двух: его обработала программа сайта (например, API) или веб-сервер сам записал файл на диск. Второе бывает, когда на сервере включён WebDAV — запись файлов силами самого веб-сервера. Проверьте это двумя командами.

Для nginx:

sudo grep -Rn 'dav_methods' /etc/nginx/

Пустой ответ — запись файлов в nginx не включена. Строки, в которых перед dav_methods стоит знак #, тоже не в счёт: это комментарии. Запись включена, если после dav_methods перечислены методы — например, dav_methods PUT DELETE;. Если такая строка нашлась и добавляли её не вы, посмотрите, закрыт ли этот адрес паролем (директива auth_basic в том же блоке или уровнем выше) или списком разрешённых IP-адресов (директивы allow и deny). Без такой защиты записать файл на сервер может любой, кто знает адрес.

Для Apache:

sudo apache2ctl -M | grep dav

Пустой ответ — модуль WebDAV в Apache не подключён. Если в ответе есть строки dav_module и dav_fs_module, найдите, для какой папки запись включена:

sudo grep -RniE 'dav\s+on' /etc/apache2/

Команда покажет файл и номер строки с директивой Dav On. Откройте этот файл: папка или адрес названы в первой строке блока, внутри которого стоит директива, — <Directory …> или <Location …>. Пустой ответ — запись не включена ни для одной папки.

Если обе проверки ничего не показали, код 201, по всей видимости, выставила программа сайта — WordPress, Laravel или ваш API. И ещё одно: если на запрос PUT сервер ответил кодом на 4 — например, 405, — запрос отклонён и файл не создан.

Когда отвечать 201, а когда 200, 202 или 204

Этот раздел — для тех, кто пишет свой API. Код ответа выбирает ваша программа, и выбор зависит от того, что запрос сделал на сервере:

Что сделал запросКакой код отправить
POST создал новую запись201 и адрес записи в заголовке Location
PUT создал запись или файл по адресу запроса201
PUT изменил то, что уже было200, если в ответе есть данные, или 204, если тела нет
Запрос принят, но выполнится позже — например, задача встала в очередь202 Accepted
Запись удалена204 или 200
Данные не прошли проверку422, если формат верный, но выполнить запрос нельзя, или 400, если запрос составлен с ошибкой
Запрос противоречит тому, что уже есть на сервере, — например, запись с таким именем уже существует409
Запись создана, и браузер нужно отправить на её страницу303 с адресом в Location

Стандарт HTTP говорит об этом прямо. Если запрос POST создал ресурс, серверу следует ответить 201 и указать адрес созданного в заголовке Location. Если ресурс создан запросом PUT, сервер обязан ответить 201. А на запрос GET код 201 не подходит: GET — запрос на чтение, клиент не просит ничего создавать.

Сомневаетесь между 200 и 201 — отвечайте 201 только тогда, когда запрос действительно добавил новое. Клиенту это полезно: по коду он понимает, что запись создана, а не обновлена.

Заголовок Location в ответе 201

В ответе 201 заголовок Location сообщает адрес созданного ресурса. Это справка для программы, а не команда перейти. Тот же заголовок в ответах 301, 302, 303, 307 и 308 работает иначе: там браузер сам переходит по указанному адресу.

Вот что показала проверка на тестовом сервере, который отвечал кодом 201 с заголовком Location:

  • Chrome 157 показал тело ответа и не пошёл по адресу из Location — и когда адрес открывали напрямую, и когда отправляли форму;
  • curl 8.7.1 с ключом -L, который велит идти по перенаправлениям, второго запроса не сделал: этот ключ срабатывает только на кодах, которые начинаются с тройки.

Отсюда вывод: если после отправки формы посетителя нужно перевести на новую страницу, отвечайте не 201, а 303 See Other. Код 201 подходит для API, где ответ читает программа.

Адрес в Location бывает полным (https://example.com/api/orders/125) или относительным (/api/orders/125). Относительный отсчитывается от адреса, на который отправили запрос.

Как прочитать адрес из ответа

В терминале код и адрес показывает одна команда curl:

curl -s -o /dev/null -w '%{http_code} %header{location}\n' --json '{"name":"test"}' https://example.com/api/orders/

Ответ — одна строка:

201 /api/orders/125

Переменная %header{location} есть в curl с версии 7.84.0, ключ --json — с версии 7.82.0. В Ubuntu 24.04 стоит curl 8.5.0, там работает и то и другое. Команда отправляет настоящий запрос: если адрес создаёт записи, на сайте появится тестовая запись — потом удалите её.

В JavaScript адрес читают из заголовков ответа:

async function createOrder() {
  const response = await fetch('/api/orders/', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({name: 'test'})
  });
  console.log(response.status);                  // 201
  console.log(response.headers.get('Location')); // /api/orders/125
}

Запрос на другой сайт: Location равен null

Если страница отправляет запрос на другой сайт — другой домен, поддомен или порт, — response.headers.get('Location') вернёт null, хотя сервер заголовок прислал. Так устроена защита в браузере: скрипту с чужого сайта видна только часть заголовков ответа, и Location в неё не входит.

Чтобы скрипт получил адрес, сервер, который отвечает 201, должен добавить в ответ ещё один заголовок:

Access-Control-Expose-Headers: Location

В PHP это строка header('Access-Control-Expose-Headers: Location'); — её ставят рядом с остальными заголовками ответа. Проверка в Chrome 157: без этого заголовка скрипт получил код 201 и null вместо адреса, с ним — /api/orders/125.

Как отправить 201 из своей программы

PHP

Код задаёт функция http_response_code, адрес созданного — функция header:

<?php
// ... здесь программа создаёт заказ и получает его номер
$id = 125;

http_response_code(201);
header('Location: /api/orders/' . $id);
header('Content-Type: application/json');
echo json_encode(['id' => $id, 'name' => 'test']);

То же самое можно записать короче — третий аргумент функции header задаёт код ответа:

header('Location: /api/orders/125', true, 201);

Обе функции вызывайте до вывода данных — до первого echo и до любого текста вне <?php.

Не отправляйте заголовок Location без кода. Получив одну строку header('Location: …'), PHP сам меняет код ответа на перенаправление: под PHP-FPM — на 302, а под Apache с модулем PHP на запрос POST по HTTP/1.1 или HTTP/2 — на 303. Клиент уйдёт по этому адресу, и вместо «создано» получится переадресация. Замены не будет, если код 201 задан до вызова, после него или третьим аргументом.

Laravel

Laravel сам отвечает 201, если маршрут или метод контроллера возвращает только что созданную модель:

public function store(Request $request)
{
    $data = $request->validate(['name' => 'required|string']);

    return Order::create($data);   // ответ уйдёт с кодом 201
}

Заголовка Location в таком ответе нет. Чтобы добавить его, соберите ответ сами:

$order = Order::create($data);

return response()->json($order, 201, ['Location' => '/api/orders/' . $order->id]);

Ресурсы API — классы на основе JsonResource — ведут себя так же: для только что созданной модели Laravel ставит код 201.

WordPress

В своём адресе REST API код задают методом set_status объекта ответа, а адрес созданного — методом header. Так делает и само ядро WordPress:

$response = rest_ensure_response( $data );
$response->set_status( 201 );
$response->header( 'Location', rest_url( 'myplugin/v1/items/' . $id ) );

return $response;

Как 201 отвечает сам веб-сервер: WebDAV

WebDAV — расширение HTTP, которое позволяет работать с файлами на сервере как с сетевой папкой: загружать их запросом PUT, создавать папки запросом MKCOL, копировать и переносить запросами COPY и MOVE, удалять запросом DELETE. Когда WebDAV включён, код ответа выбирает сам веб-сервер:

Запросnginx 1.24.0Apache 2.4.67 с mod_dav
PUT: файла ещё не было201 и Location201 и Location
PUT: файл уже был204204
MKCOL: новая папка201 и Location201 и Location
COPY или MOVE файла в новое место204201 и Location
COPY или MOVE файла поверх существующего204204
COPY или MOVE папки в новое место201201 и Location
DELETE204204
PUT или DELETE на адрес файла, когда запись не включена405405

Столбец Apache получен на тестовом сервере с Apache 2.4.67, столбец nginx — по исходному коду версии 1.24.0. Главное различие — в строке про копирование и перенос файла в новое место: Apache отвечает 201, nginx — 204. И ещё одно: на PUT nginx отвечает без тела, а Apache прикладывает к ответу 201 короткую HTML-страницу. Последняя строка относится к запросам, которые веб-сервер разбирает сам; если запрос попадает в программу сайта, код выбирает она.

В nginx запись файлов включает директива dav_methods; по умолчанию она выключена (off). Нужный для неё модуль уже есть в пакете nginx из Ubuntu 24.04. Пример настройки — в документации nginx.

В Apache из Ubuntu модуль WebDAV установлен, но выключен. Его подключает команда sudo a2enmod dav_fs с последующим перезапуском Apache, а запись в нужной папке включает директива Dav On. О команде a2enmod — на странице a2enmod и a2dismod.

Включайте запись файлов только вместе с паролем на этот адрес. Без пароля любой, кто знает адрес, сможет записать на сервер свои файлы. Как поставить пароль: в nginx, в Apache.

Как проверить, каким кодом отвечает сервер

Команду выполняйте в терминале на своём компьютере, подставив адрес своего сайта. Если терминал вам незнаком, начните с инструкции Как открыть терминал и выполнить команду. Команда отправит POST с данными в формате JSON и покажет ответ вместе с заголовками:

curl -i --json '{"name":"test"}' https://example.com/api/orders/

Ответ сервера, который создал запись, — для краткости здесь оставлены только главные заголовки:

HTTP/1.1 201 Created
Location: /api/orders/125
Content-Type: application/json

{"id":125,"name":"test"}

Код стоит в первой строке. По HTTP/2 она выглядит как HTTP/2 201, а названия заголовков приходят строчными буквами — например, location: /api/orders/125.

Нужен только код — добавьте ключи, которые прячут всё остальное:

curl -s -o /dev/null -w '%{http_code}\n' --json '{"name":"test"}' https://example.com/api/orders/

Команда выведет одно число: 201.

Обе команды отправляют настоящий запрос. Если адрес создаёт записи, на рабочем сайте появится тестовая запись — потом удалите её.

Ключ --json есть в curl с версии 7.82.0. Команды рассчитаны на терминал Linux и macOS.

В браузере код видно в инструментах разработчика на вкладке Network («Сеть»), в колонке статуса.

201 и поисковые роботы

Страницы, которые открывают посетители и поисковые роботы, должны отвечать кодом 200. Код 201 — для ответов на запросы, которые что-то создают, а робот страницы только читает.

Что будет, если страница всё же ответит 201, описано в справке Google о кодах ответа: получив 201, робот ждёт содержимое ограниченное время, а затем передаёт на обработку то, что успел получить. Сколько именно он ждёт, зависит от робота.

Если страница сайта, которая открывается по ссылке, отвечает 201 — это ошибка в программе сайта. Найдите место, где выставляется код: в PHP это вызов http_response_code(201) или число 201 в третьем аргументе функции header. Для страниц, которые только показывают данные, код должен быть 200.

Чем 201 отличается от соседних кодов

КодЧто значитПример
200 OKЗапрос выполнен, нового ничего не созданоСервер отдал страницу или список заказов
201 CreatedЗапрос выполнен, создан новый ресурсОформлен заказ, загружен файл
202 AcceptedЗапрос принят, но ещё не выполнен — и может не выполнитьсяЗадача поставлена в очередь
204 No ContentЗапрос выполнен, тела в ответе нетЗапись удалена, настройка сохранена
303 See OtherРезультат лежит по другому адресу, браузер запросит его методом GETПереход на страницу заказа после отправки формы
409 ConflictЗапрос противоречит тому, что уже есть на сервереЗапись с таким именем уже существует

Ответы на вопросы

Код 201 — это ошибка? Нет. Это успешный ответ: сервер выполнил запрос и создал то, о чём его просили, — запись, файл или папку. Исправлять ничего не нужно.

Чем код 201 отличается от 200? Оба значат успех. 200 — запрос выполнен; 201 — запрос выполнен, и на сервере появилось что-то новое. Для посетителя разницы нет, а программе код 201 подсказывает, что запись именно создана и её адрес может лежать в заголовке Location.

Чем 201 отличается от 202 и 204? 201 — запрос уже выполнен, и создано новое. 202 — запрос только принят: сервер выполнит его позже и может не выполнить вовсе. 204 — запрос выполнен, но тела в ответе нет; так отвечают, например, на удаление записи.

Что значит 201 в журнале сервера — нужно ли что-то делать? Это запись об успешном запросе, который что-то создал: например, так WordPress отвечает на загрузку картинки в редакторе блоков. Делать ничего не нужно. Проверка нужна в одном случае — если это запрос PUT, а загрузку файлов вы не настраивали: смотрите раздел «Если в журнале запрос PUT с кодом 201, а загрузку файлов вы не настраивали».

Почему в журнале сайта на WordPress запросы POST /wp-json/wp/v2/media с кодом 201? Так редактор блоков загружает файлы: картинка, которую вы добавили с компьютера, уходит на сервер таким запросом. Загружать файлы может только пользователь, который вошёл на сайт и имеет на это право.

Почему браузер не переходит по адресу из Location? Потому что по адресу из Location браузер переходит только при кодах перенаправления — 301, 302, 303, 307 и 308. В ответе 201 этот заголовок лишь сообщает адрес созданного. Нужен переход после отправки формы — отвечайте 303.

Обязателен ли заголовок Location в ответе 201? Нет. Без него созданным считается ресурс по адресу самого запроса — так бывает при PUT, когда файл загружают сразу на его будущий адрес. Для POST стандарт советует указывать адрес в Location.

Должно ли у ответа 201 быть тело? Не обязано. WordPress и Laravel возвращают в теле созданную запись в формате JSON, nginx при записи файла отвечает без тела, Apache прикладывает короткую HTML-страницу.

Можно ли ответить 201 на запрос GET? Технически сервер может отправить любой код, но по смыслу это неверно: GET — запрос на чтение, он ничего не создаёт. Страница, которую открывают посетители и поисковые роботы, должна отвечать 200.

Что вернуть, если такая запись уже есть? Код 201 не подходит: ничего нового не создано. Если запрос противоречит тому, что уже лежит на сервере, — например, имя занято, — подходит 409. Если результат запроса совпадает с уже существующей записью, стандарт разрешает ответить 303 с её адресом в Location.

Кешируется ли ответ 201? Сам по себе нет: в списке кодов, которые стандарт разрешает кешировать без явного указания, кода 201 нет. Ответ на POST кеш может сохранить, только если сервер явно задал срок хранения и добавил заголовок Content-Location с адресом запроса.

Программа считает ответ 201 ошибкой — что делать? Запрос выполнен, запись создана. Не отправляйте его повторно: может появиться вторая такая же запись. Исправить нужно саму программу — пусть считает успехом любой код от 200 до 299, а не только 200.

Страница сайта отвечает 201 вместо 200 — это плохо? Да, это ошибка в программе сайта: страницам нужен код 200. По справке Google, получив 201, робот ждёт содержимое ограниченное время и передаёт дальше то, что успел получить. Найдите в программе место, где выставляется 201, и уберите его для страниц, которые только показывают данные.

Источники

Сверено 16 ноября 2026 года. Ответы Apache получены на тестовом сервере с Apache 2.4.67 запросами curl 8.7.1, поведение браузера проверено в Chrome 157; поведение nginx сверено по исходному коду версии 1.24.0; команда для журнала проверена в Ubuntu 24.04; примеры для PHP, Laravel и WordPress сверены по исходному коду и справке, на сервере не запускались.

Что почитать дальше