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).
В начало страницы