Формат POST-запроса на сканирование

POST-запросы на сканирование объекта имеют следующий формат:

* Заголовки запроса *

* Тело запроса *

{

"timeout": "%TIMEOUT%",

"omitCleanSubobjectResults": "%TO_OMIT_CLEAN_SUBOBJECT_RESULTS%",

"url": "%URL%",

"hostIp": "%HOST_IP%",

"requestHeaders": "%REQUEST_HEADERS%",

"responseHeaders": "%RESPONSE_HEADERS%",

"object": "%OBJECT%",

"name": "%SCAN_OBJECT_NAME%"

}

Здесь:

• timeout – время ожидания сканирования объекта (в миллисекундах). Это поле не является обязательным.
• omitCleanSubobjectResults – переменная логического типа, которая определяет, будут ли включены в массив subObjectsScanResults вложенные объекты с результатом сканирования CLEAN. Если указано значение true, такие объекты не будут включены в массив; если указано значение false, то такие объекты включаются в массив. Значение по умолчанию: true. Это поле не является обязательным.

  Смотрите также подробную информацию о структуре массива subObjectsScanResults.

• url – URL-адрес, который будет использован как контекст для запроса на сканирование. Это поле не является обязательным.

  Это поле можно использовать для повышения коэффициента обнаружения.

• hostIp – IP-адрес хоста, на котором размещен просканированный URL-адрес. Это поле не является обязательным.

  Это поле можно использовать для повышения коэффициента обнаружения. Вам необходимо включить KSN, чтобы использовать это поле.

• requestHeaders – заголовки HTTP-запроса, извлеченные из HTTP-трафика. Это поле не является обязательным.

  Это поле можно использовать для повышения коэффициента обнаружения.

• responseHeaders – заголовки HTTP-ответа, извлеченные из HTTP-трафика. Это поле не является обязательным.

  Это поле можно использовать для повышения скорости обнаружения.

• object – абсолютный путь до файла, который нужно просканировать (если запрос послан к /api/v3.0/scanfile), или строка, закодированная по алгоритму Base64 (если запрос послан к /api/v3.0/scanmemory). В этом поле можно указать только один объект. Это поле является обязательным для заполнения.
• name – имя объекта для сканирования в режиме scanmemory (если запрос послан к /api/v3.1/scanmemory). Значение может быть от 1 до 300 символов Юникода. Это поле не является обязательным.

Специальные символы в теле запроса должны быть экранированы, как указано в Standard ECMA-404 (The JSON Interchange Syntax).