Заголовки запросов
14 июля 2026
ID 181073
HTTP-запрос к Kaspersky Scan Engine методом POST должен содержать заголовок Content-Length.
При отправке HTTP-запроса вы можете задавать три заголовка запроса, специфичные для Kaspersky Scan Engine:
X-KAV-ProtocolVersionЭтот заголовок определяет используемую версию протокола KAV. Этот заголовок является обязательным.
X-KAV-TimeoutЭтот заголовок указывает время ожидания операции сканирования в миллисекундах (но не время ожидания сеанса). Этот заголовок не является обязательным.
Этот заголовок принимает значения от
0до4294967295(32-разрядное целое положительное число). Задайте значение в зависимости от характеристик проверяемого объекта (например, его размера, является ли он составным или нет; Kaspersky Scan Engine дольше проверяет большой составной объект).Смотрите также подробную информацию о времени ожидания сканирования и времени ожидания сеанса.
X-KAV-ObjectURLЭтот заголовок содержит контекст задачи проверки, который Kaspersky Scan Engine использует для повышения коэффициента обнаружения. Этот заголовок не является обязательным.
Использование этого заголовка не влияет на производительность сканирования.
Мы рекомендуем вам использовать контекст задачи сканирования при интеграции типа gateway.
Используйте следующий формат для контекста:
- Если объект для сканирования был получен из интернета, укажите веб-адрес источника, включая протокол, например:
http://example.com
Поддерживаются протоколы HTTP, HTTPS и FTP.
Если URL-адрес неизвестен, мы рекомендуем использовать
http://example.comв качестве контекста задачи сканирования. - Если объект для сканирования был получен по электронной почте, укажите адрес отправителя в следующем формате:
[from:%sender_address%], например:[from:example@example.com]
Если адрес отправителя неизвестен, рекомендуется использовать
[from:test@relay.example]в качестве контекста задачи сканирования.
Контекст задачи сканирования применим только к проверке файлов и памяти. Если вы укажете контекст задачи сканирования для URL-адреса, он будет проигнорирован.
- Если объект для сканирования был получен из интернета, укажите веб-адрес источника, включая протокол, например:
X-KAV-HostIPЭтот заголовок указывает IP-адрес хоста, на котором размещен URL-адрес для сканирования. Добавление его в запрос увеличивает коэффициент обнаружения.