Параметры запроса
Параметр
|
Описание
|
Допустимые значения
|
Примечание
|
id
|
Идентификатор станции
|
–
|
Обязательный параметр: да
|
from
|
Дата начала периода, за который запрашиваются статистические данные
|
Задается в формате: YYYYMMDD или YYYYMMDDHHmmss
|
Обязательный параметр: нет.
Если параметр не задан, то статистика возвращается за текущий месяц.
|
till
|
Дата окончания периода, за который запрашиваются статистические данные
|
Задается в формате: YYYYMMDD или YYYYMMDDHHmmss
|
Обязательный параметр: нет.
Если параметр не задан, то статистика возвращается за текущий месяц.
|
Пример запроса
http://192.168.1.1:9080/api/stations/infections-chart.ds?id=d071625c-d21d-b211-9bc4-bc02713bf843&from=1559314800&till=1559746799
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.0" timestamp="1559825131" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<infections-chart total="1" period_from="1559314800" period_till="1559746799">
<item time="1559746799">
<infected>0</infected>
<cured>0</cured>
<moved>0</moved>
<renamed>0</renamed>
<deleted>0</deleted>
<locked>14</locked>
</item>
<item time="1559401199">
<infected>0</infected>
<cured>0</cured>
<moved>0</moved>
<renamed>0</renamed>
<deleted>0</deleted>
<locked>0</locked>
</item>
</infections-chart>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <infections-chart /> содержит информацию о результатах всех запусков сканирования на станции.
Атрибуты элемента <infections-chart />:
Атрибут
|
Описание
|
total
|
Общее количество станций
|
period_from
|
Дата начала периода, за который запрашиваются статистические данные
|
period_till
|
Дата окончания периода, за который запрашиваются статистические данные
|
•Элемент <item /> содержит информацию о проведенных действиях после конкретного сканирования станции. Атрибут элемента <item />:
Атрибут
|
Описание
|
time
|
Дата и время передачи Агентом Dr.Web результатов сканирования
|
Вложенные элементы элемента <item />:
Элемент
|
Описание
|
<infected />
|
Количество инфицированных объектов
|
<cured />
|
Количество вылеченных объектов
|
<moved />
|
Количество объектов, перемещенных в карантин
|
<renamed />
|
Количество переименованных объектов
|
<deleted />
|
Количество удаленных объектов
|
<locked />
|
Количество заблокированных объектов
|
Значением данных элементов является количество объектов, над которыми было совершенно действие, соответствующее данному элементу.
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1559737436,
"api": {
"version": 40300,
"versionString": 4.3.0},
"server": {
"name": "192.168.1.1",
"version": "12.00.0.201909260",
"uuid": "76b05bc0-8691-11e9-63e5-7036cecd07fa"}},
"data": {
"period_from": "1559314800",
"period_till": "1559746799",
"chart": {
"1559746799": {
"cured": 0,
"deleted": 0,
"infected": 0,
"locked": 14,
"moved": 10,
"renamed": 0},
"1559401199": {
"cured": 0,
"deleted": 0,
"infected": 0,
"locked": 0,
"moved": 10,
"renamed": 0}}}}
|
Описание параметров ответного JSON
Блок data содержит общую информацию о запросе и блоки с запрошенной статистической информацией.
Элементы блока data:
Название поля
|
Описание
|
period_from
|
Дата начала периода, за который запрашиваются статистические данные
|
period_till
|
Дата окончания периода, за который запрашивались статистические данные
|
•Блок chart содержит блоки информации о результатах всех запусков сканирования на станции. Элементы блока chart:
Название поля
|
Описание
|
Дата и время передачи Агентом Dr.Web результатов сканирования
|
Статистика проведенных действий после конкретного сканирования станции:
•infected — количество зараженных объектов, •cured — количество вылеченных объектов, •moved — количество объектов, перемещенных в карантин, •deleted — количество удаленных объектов, •renamed — количество переименованных объектов, •locked — количество заблокированных объектов |
|