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

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

Параметр

Описание

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

id

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

Параметр может быть указан в запросе неограниченное количество раз для получения списков установленных компонентов для нескольких станций одновременно.

да

 

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

http://192.168.1.1:9080/api/stations/installed-components.ds?id=88e984a0-6031-11e9-5b7e-f4ffebd769bf

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

 

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

<drweb-es-api api_version="4.3.0" timestamp="1561552101" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <stations total="1">
     <station id="88e984a0-6031-11e9-5b7e-f4ffebd769bf">
        <components total="10">
           <component code="144" name="Dr.Web Preventive Protection" installed="1559729080" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="4" name="Dr.Web Scanner for Windows" installed="1561445724" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="14" name="SpIDer Mail for Windows workstations" installed="1561445724" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="30" name="Dr.Web Agent for Windows" installed="1561445694" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="37" name="Dr.Web Agent Scanner for Windows" installed="1561445694" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="38" name="SpIDer Gate for Windows workstations" installed="1561445696" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="54" name="Dr.Web Office Control" installed="1561445723" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="55" name="Dr.Web Antispam" installed="1561445690" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="57" name="SpIDer Guard for Windows workstations" installed="1561445724" path="C:\Windows\system32\drivers\" server="tcp/192.168.10.93:2193"/>

           <component code="124" name="Dr.Web Self-protection" installed="1561445725" path="C:\Windows\system32\drivers\" server="tcp/192.168.10.93:2193"/>
        </components>
     </station>
  </stations>
</drweb-es-api>

 

Описание параметров ответного XML

Элемент <stations /> содержит информацию обо всех запрашиваемых станциях.

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

Атрибут

Описание

total

Общее количество станций, информация о которых приведена в ответе

Элемент <station /> содержит информацию о конкретной станции.

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

Атрибут

Описание

id

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

Элемент <components /> содержит информацию обо всех компонентах, установленных на конкретной станции.

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

Атрибут

Описание

total

Общее количество компонентов, установленных на данной станции

Элемент <component /> содержит информацию о конкретном установленном компоненте.

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

Атрибут

Описание

code

Числовой код компонента (см. в разделе Коды компонентов)

name

Название компонента (см. в разделе Коды компонентов)

installed

Время установки компонента в формате UNIX timestamp

path

Путь установки данного компонента

server

Адрес Сервера, с которого был установлен данный компонент. Для компонентов, установленных с текущего Сервера, атрибут server содержит пустое значение.

 

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

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

    "timestamp": 1561552119,

    "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": {
    "total": 1,

    "list": [{
      "components": [
          {"code": 144,
          "installed_time": 1559729080,

          "name": "Dr.Web Preventive Protection",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 4,
          "installed_time": 1561445724,

          "name": "Dr.Web Scanner for Windows",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 14,
          "installed_time": 1561445724,

          "name": "SpIDer Mail for Windows workstations",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 30,
          "installed_time": 1561445694,

          "name": "Dr.Web Agent for Windows",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 37,
          "installed_time": 1561445694,

          "name": "Dr.Web Agent Scanner for Window",

          "path": "C:\\Program Files\\DrWeb",
          "server": "tcp/192.168.1.1:2193"},

          {"code": 38,
          "installed_time": 1561445696,

          "name": "SpIDer Gate for Windows workstations",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 54,
          "installed_time": 1561445723,

          "name": "Dr.Web Office Control",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 55,
          "installed_time": 1561445690,

          "name": "Dr.Web Antispam",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 57,
          "installed_time": 1561445724,

          "name": "SpIDer Guard for Windows workstations",

          "path": "C:\\Windows\\system32\\drivers\\",
          "server": "tcp/192.168.10.93:2193"},

          {"code": 124,
          "installed_time": 1561445725,

          "name": "Dr.Web Self-protection",

          "path": "C:\\Windows\\system32\\drivers\\",
          "server": "tcp/192.168.10.93:2193"}],
      "station_id": "88e984a0-6031-11e9-5b7e-f4ffebd769bf"}]}}

 

Описание параметров ответного JSON

Блок data содержит информацию обо всех запрашиваемых станциях.

Элементы блока data:

Название поля

Описание

total

Общее количество станций, информация о которых приведена в ответе

Массив list содержит информацию о конкретных запрашиваемых станциях.

Элементы объектов в массиве list:

Название поля

Описание

station_id

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

Массив components содержит информацию обо всех компонентах, установленных на станции.

Элементы объектов в массиве components:

Название поля

Описание

code

Числовой код компонента (см. в разделе Коды компонентов)

installed_time

Время установки компонента в формате UNIX timestamp

name

Название компонента (см. в разделе Коды компонентов)

path

Путь установки данного компонента

server

Адрес Сервера, с которого был установлен данный компонент. Для компонентов, установленных с текущего Сервера, атрибут server содержит пустое значение.