|
Параметры запроса
Параметр
|
Описание
|
Обязательный
|
action-adware
|
Действие при обнаружении рекламных программ:
•delete — удалять,
•ignore — игнорировать,
•quarantine — перемещать в Карантин |
нет
|
action-dialers
|
Действие при обнаружении программ дозвона:
•delete — удалять,
•ignore — игнорировать,
•quarantine — перемещать в Карантин |
нет
|
action-hacktools
|
Действие при обнаружении программ взлома:
•delete — удалять,
•ignore — игнорировать,
•quarantine — перемещать в Карантин |
нет
|
action-incurable-files
|
Действие при невозможности лечения зараженного объекта:
•delete — удалять,
•quarantine — перемещать в Карантин |
нет
|
action-infected-archive
|
Действие при обнаружении вредоносных архивов:
•delete — удалять,
•quarantine — перемещать в Карантин |
нет
|
action-infected-boot
|
Действие при обнаружении инфицированных загрузочных секторов:
•cure — лечить,
•report — отправлять оповещение на Сервер Dr.Web |
нет
|
action-infected-container
|
Действие при обнаружении вредоносных файловых контейнеров:
•delete — удалять,
•quarantine — перемещать в Карантин |
нет
|
action-infected-files
|
Действие при обнаружении вредоносных файлов:
•cure — лечить,
•delete — удалять,
•quarantine — перемещать в Карантин |
нет
|
action-infected-mail
|
Действие при обнаружении вредоносных почтовых файлов:
•ignore — игнорировать,
•quarantine — перемещать в Карантин,
•report — сообщать |
нет
|
action-jokes
|
Действие при обнаружении программ-шуток:
•delete — удалять,
•ignore — игнорировать,
•quarantine — перемещать в Карантин |
нет
|
action-riskware
|
Действие при обнаружении потенциально опасных программ:
•delete — удалять,
•ignore — игнорировать,
•quarantine — перемещать в Карантин |
нет
|
action-suspicious-files
|
Действие при обнаружении подозрительных файлов:
•delete — удалять,
•ignore — игнорировать,
•quarantine — перемещать в Карантин |
нет
|
id
|
Идентификатор станции.
Параметр может быть указан в запросе неограниченное количество раз для запуска сканирования на нескольких станциях одновременно.
|
да
|
reboot
|
Задание автоматической перезагрузки компьютера пользователя после окончания сканирования, если в процессе проверки были обнаружены вредоносные объекты, для завершения лечения которых требуется перезагрузка операционной системы.
Допустимые значения: yes | no.
|
нет
|
type
|
Тип сканирования.
Допустимые значения:
•full — полное сканирование,
•quick — быстрое сканирование.
По умолчанию: quick.
|
нет
|
Пример запроса
https://192.168.1.1:9081/api/stations/start-scanner.ds?id=1001&id=1002
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.2" timestamp="1587457437" server="192.168.1.1" srv_version="13.00.1.202310121" status="true">
<stations total="2">
<station id="1001" status="initiated"/>
<station id="1002" status="failed"/>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию о запуске сканирования на станциях, указанных в запросе.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций в ответе
|
•Элемент <station /> содержит информацию о запуске сканирования конкретной станции.
Атрибуты элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
status
|
Статус запуска удаленного сканирования:
•failed — запуск сканирования завершился с ошибкой,
•initiated — сканирование инициировано. |
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1587458243,
"api": {
"version": 40302,
"versionString": "4.3.2"},
"server": {
"name": "192.168.1.1",
"version": "13.00.1.202310121",
"uuid": "b35d999d-9212-481d-af8c-8551c4113383"}},
"data": {
"total": 2,
"list": {
"1002": "failed",
"1001": "initiated"}}}
|
Описание параметров ответного JSON
Блок data содержит информацию о запуске сканирования на станциях, указанных в запросе.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций в ответе
|
list
|
Блок с результатами запуска сканирования для каждой станции
|
•Элементы блока list:
Название поля
|
Описание
|
Идентификатор станции
|
Статус запуска удаленного сканирования:
•failed — сканирование завершилось с ошибкой,
•initiated — сканирование инициировано. |
|