Метод HTTP TRACE выполняет проверку эхо-запроса сообщения по пути к целевому ресурсу.

Конечный получатель запроса должен отразить полученное сообщение (за исключением любых полей, которые могут содержать конфиденциальные данные) обратно клиенту в виде тела сообщения ответа 200 OK с типом Content-Type message/http. Конечным получателем является либо исходный сервер, либо первый сервер, получивший в запросе значение 0 для заголовка Max-Forwards.

Клиент не должен отправлять содержимое в запросе или создавать заголовки, которые могут содержать конфиденциальные данные, например учетные данные пользователя или файлы cookie. Не все серверы реализуют метод TRACE, а некоторые владельцы серверов исторически запрещали использование метода TRACE из соображений безопасности. В таких случаях будет отправлен 405 Method Not Allowed — ответ об ошибке клиента.

Синтаксис

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

Примеры

Успешный запрос TRACE

Запрос TRACE можно выполнить с помощью curl:

curl -v -X TRACE example.com

В результате будет сформирован следующий HTTP-запрос:

TRACE / HTTP/1.1
Host: example.com
User-Agent: curl/8.7.1
Accept: */*

Клиенту отправляется ответ 200 OK, содержащий заголовки запроса в теле ответа:

HTTP/1.1 200 OK
Content-Length: 123
Date: Wed, 04 Sep 2024 11:50:24 GMT
Server: Apache/2.4.59 (Unix)
Content-Type: message/http

TRACE / HTTP/1.1
Host: example.com
User-Agent: curl/8.7.1
Accept: */*

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

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

Браузер не использует метод TRACE для действий, инициированных пользователем, поэтому понятие «совместимость с браузерами» здесь неприменимо.

См. также

• Методы HTTP-запросов
• Коды состояния HTTP-ответов
• Заголовки HTTP
• Межсайтовая трассировка (XST)