Метод HTTP HEAD запрашивает метаданные ресурса в виде заголовков, которые сервер отправил бы, если бы вместо него использовался метод GET. Этот метод можно использовать в случаях, когда URL может привести к загрузке большого объёма данных: например, запрос HEAD может прочитать заголовок Content-Length, чтобы проверить размер файла перед его загрузкой с помощью GET.

Если ответ на запрос HEAD показывает, что кэшированный ответ URL устарел, кэшированная копия становится недействительной, даже если запрос GET не выполнялся.

Синтаксис

HEAD <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.

Примеры

Успешное получение метаданных ресурса

Следующая команда curl создаёт запрос HEAD для example.com:

curl --head example.com

Это эквивалент запроса GET, за исключением того, что сервер не должен включать в ответ тело сообщения. В результате создаётся HTTP-запрос следующего вида:

HEAD / HTTP/1.1
Host: example.com
User-Agent: curl/8.6.0
Accept: */*

Сервер отправляет ответ 200 OK, состоящий только из заголовков. По сути, ответ содержит метаданные, описывающие ресурс, а не сам ресурс (в этом примере некоторые заголовки, связанные с кэшированием, опущены для краткости):

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Wed, 04 Sep 2024 10:33:11 GMT
Content-Length: 1234567

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

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

См. также

• Методы HTTP-запросов
• Коды состояния HTTP-ответов
• Заголовки HTTP
• метод GET