|
Параметры запроса
Параметр
|
Описание
|
Обязательный
|
id
|
Идентификатор группы
|
да
|
from
|
Дата начала периода, за который запрашиваются статистические данные.
Задается в формате: YYYYMMDD или YYYYMMDDHHmmss.
Если параметр не задан, то статистика возвращается за текущий месяц.
|
нет
|
till
|
Дата окончания периода, за который запрашиваются статистические данные.
Задается в формате: YYYYMMDD или YYYYMMDDHHmmss.
Если параметр не задан, то статистика возвращается за текущий месяц.
|
нет
|
Пример запроса
https://192.168.1.1:9081/api/groups/infections-chart.ds?id=7ec98a70-5c83-11ea-512f-70a167e08535&from=20193105&till=20190605
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.2" timestamp="1588876162" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
<infections-chart period_from="1559314800" period_till="1559746799">
<item time="1559746799">
<infected>0</infected>
<modifications>0</modifications>
<suspicious>2</suspicious>
<activities>0</activities>
<cured>0</cured>
<moved>10</moved>
<renamed>0</renamed>
<deleted>0</deleted>
<locked>14</locked>
</item>
<!-- etc. Skipped in documentation -->
<item time="1559401199">
<infected>0</infected>
<modifications>0</modifications>
<suspicious>0</suspicious>
<activities>0</activities>
<cured>0</cured>
<moved>10</moved>
<renamed>0</renamed>
<deleted>0</deleted>
<locked>0</locked>
</item>
</infections-chart>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <infections-chart /> содержит статистику примененных действий по результатам всех запусков сканирования в группе.
Атрибуты элемента <infections-chart />:
Атрибут
|
Описание
|
period_from
|
Дата начала периода, за который запрашиваются статистические данные
|
period_till
|
Дата окончания периода, за который запрашиваются статистические данные
|
•Элемент <item /> содержит информацию о примененных действиях после конкретного сканирования в группе.
Атрибут элемента <item />:
Атрибут
|
Описание
|
time
|
Дата и время передачи Агентом Dr.Web результатов сканирования
|
▫Вложенные элементы элемента <item />:
Элемент
|
Описание
|
<infected />
|
Количество инфицированных объектов
|
<modifications />
|
Количество объектов, инфицированных модификациями угроз
|
<suspicious />
|
Количество подозрительных объектов
|
<activities />
|
Количество вредоносных действий
|
<cured />
|
Количество вылеченных объектов
|
<moved />
|
Количество объектов, перемещенных в Карантин
|
<renamed />
|
Количество переименованных объектов
|
<deleted />
|
Количество удаленных объектов
|
<locked />
|
Количество заблокированных объектов
|
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1588876993,
"api": {
"version": 40302,
"versionString": "4.3.2"},
"server": {
"name": "192.168.1.1",
"version": "13.00.0.202005090",
"uuid": "76b05bc0-8691-11e9-63e5-7036cecd07fa"}},
"data": {
"period_from": "1559314800",
"period_till": "1559746799",
"chart": {
"1559746799": {
"infected": 0,
"modifications": 0,
"suspicious": 2,
"activities": 0,
"cured": 0,
"moved": 10,
"deleted": 0,
"renamed": 0,
"locked": 14},
...,
"1559401199": {
"infected": 0,
"modifications": 0,
"suspicious": 0,
"activities": 0,
"cured": 0,
"moved": 10,
"deleted": 0,
"renamed": 0,
"locked": 0}}}}
|
Описание параметров ответного JSON
Блок data содержит статистику примененных действий по результатам всех запусков сканирования в группе.
Элементы блока data:
Название поля
|
Описание
|
period_from
|
Дата начала периода, за который запрашиваются статистические данные
|
period_till
|
Дата окончания периода, за который запрашивались статистические данные
|
chart
|
Блок с информацией о примененных действиях после каждого сканирования в группе
|
•Блок chart состоит из вложенных блоков.
▫Каждый вложенный блок содержит статистику примененных действий после конкретного сканирования в группе. Название вложенного блока соответствует дате и времени передачи Агентом Dr.Web результатов сканирования.
Элементы вложенных блоков в блоке chart:
Название поля
|
Описание
|
infected
|
Количество инфицированных объектов
|
modifications
|
Количество объектов, инфицированных модификациями угроз
|
suspicious
|
Количество подозрительных объектов
|
activities
|
Количество вредоносных действий
|
cured
|
Количество вылеченных объектов
|
moved
|
Количество объектов, перемещенных в Карантин
|
renamed
|
Количество переименованных объектов
|
deleted
|
Количество удаленных объектов
|
locked
|
Количество заблокированных объектов
|
|