HTTP-метод DELETE запрашивает у сервера удаление указанного ресурса.

Запросы с использованием DELETE следует использовать только для удаления данных и не следует включать в них тело.

Синтаксис

DELETE <request-target>["?"<query>] HTTP/1.1

<request-target>

Определяет целевой ресурс запроса вместе с информацией, указанной в заголовке Host. В запросах к исходному серверу это абсолютный путь (например, /path/to/file.html), а в запросах к прокси-серверам — абсолютный URL (например, http://www.example.com/path/to/file.html).

<query> Необязательно

Необязательный компонент запроса, предваряемый вопросительным знаком ?. Часто используется для передачи идентификационной информации в виде пар key=value.

Примеры

Успешное удаление ресурса

Следующий запрос просит сервер удалить ресурс file.html:

DELETE /file.html HTTP/1.1
Host: example.com

Если запрос выполнен успешно, возможны несколько кодов состояния успешного ответа. Ответ 204 No Content означает, что запрос выполнен успешно и клиенту не нужно отправлять дополнительную информацию:

HTTP/1.1 204 No Content
Date: Wed, 04 Sep 2024 10:16:04 GMT

Ответ 200 OK означает, что запрос выполнен успешно, а тело ответа содержит представление с описанием результата:

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Fri, 21 Jun 2024 14:18:33 GMT
Content-Length: 1234

<html lang="en-US">
  <body>
    <h1>File "file.html" deleted.</h1>
  </body>
</html>

Ответ 202 Accepted означает, что запрос принят и, вероятно, будет выполнен успешно, но сервер ещё не удалил ресурс.

HTTP/1.1 202 Accepted
Date: Wed, 26 Jun 2024 12:00:00 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 1234

<html lang="en-US">
  <body>
    <h1>Deletion of "file.html" accepted.</h1>
    <p>See <a href="http://example.com/tasks/123/status">the status monitor</a> for details.</p>
  </body>
</html>

Спецификации

Совместимость с браузерами

Браузер не использует метод DELETE для действий, инициированных пользователем, поэтому понятие «совместимость с браузерами» здесь неприменимо. Разработчики могут задать этот метод запроса с помощью fetch().

См. также

• Коды состояния HTTP: 200, 202, 204
• Методы HTTP-запросов
• Коды состояния HTTP-ответов
• Заголовки HTTP