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

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

Параметр

Описание

Допустимые значения

Примечание

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 — количество заблокированных объектов