Получение статистики примененных действий

Параметры запроса

Параметр

Описание

Обязательный

id

Идентификатор станции

да

from

Дата начала периода, за который запрашиваются статистические данные.

Задается в формате: YYYYMMDD или YYYYMMDDHHmmss.
Если параметр не задан, то статистика возвращается за текущий месяц.

нет

till

Дата окончания периода, за который запрашиваются статистические данные.

Задается в формате: YYYYMMDD или YYYYMMDDHHmmss.
Если параметр не задан, то статистика возвращается за текущий месяц.

нет

 

Пример запроса

https://192.168.1.1:9081/api/stations/infections-chart.ds?id=1002

Ниже представлены примеры ответов в формате XML и в формате JSON.

 

Ответ в формате XML

<drweb-es-api api_version="4.3.2" timestamp="1587673642" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
  <infections-chart period_from="1587673642" period_till="1587675599">
     <item time="1587675599">
        <infected>12</infected>

        <modifications>0</modifications>

        <suspicious>2</suspicious>

        <activities>0</activities>

        <cured>1</cured>

        <moved>5</moved>

        <renamed>0</renamed>

        <deleted>0</deleted>
        <locked>0</locked>
     </item>

     <!-- etc. Skipped in documentation -->

     <item time="1585861199">
        <infected>0</infected>

        <infected>0</infected>

        <modifications>0</modifications>

        <suspicious>0</suspicious>

        <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 />:

Атрибут

Описание

period_from

Дата начала периода, за который запрашиваются статистические данные

period_till

Дата окончания периода, за который запрашиваются статистические данные

Элемент <item /> содержит информацию о примененных действиях после конкретного сканирования станции.

Атрибут элемента <item />:

Атрибут

Описание

time

Дата и время передачи Агентом Dr.Web результатов сканирования

Вложенные элементы элемента <item />:

Элемент

Описание

<infected />

Количество инфицированных объектов

<modifications />

Количество объектов, инфицированных модификациями вирусов

<suspicious />

Количество подозрительных объектов

<activities />

Количество вредоносных действий

<cured />

Количество вылеченных объектов

<moved />

Количество объектов, перемещенных в Карантин

<renamed />

Количество переименованных объектов

<deleted />

Количество удаленных объектов

<locked />

Количество заблокированных объектов

 

Ответ в формате JSON

{ "head": {
    "status": true,

    "timestamp": 1587673607,

    "api": {
      "version": 40302,
      "versionString": "4.3.2"},

    "server": {
      "name": "192.168.1.1",

      "version": "13.00.0.202005090",
      "uuid": "6d8f5aa0-850a-11ea-4c3c-c8efa441e4dd"}},

"data": {
    "period_from": 1585688400,

    "period_till": 1587675599,

    "chart": {
      "1587675599": {
          "infected": 12,

          "modifications": 0,

          "suspicious": 2,

          "activities": 0,

          "cured": 1,

          "moved": 5,

          "deleted": 0,

          "renamed": 0,
          "locked": 0},

        ...,

      "1585861199": {
          "infected": 0,

          "modifications": 0,

          "suspicious": 0,

          "activities": 0,

          "cured": 0,

          "moved": 0,

          "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

Количество заблокированных объектов