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

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

Параметр

Описание

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

id

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

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

да

 

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

https://192.168.1.1:9081/api/stations/installed-components.ds?id=1002

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

 

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

<drweb-es-api api_version="4.3.2" timestamp="1589406161" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
  <stations total="1">
     <station id="1002">
        <components total="11">
           <component code="144" name="Preventive protection" installed="1589374270" path="C:\Program Files\DrWeb" server=""/>

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

           <component code="154" name="Application Control" installed="1589388768" path="C:\Program Files\DrWeb" server=""/>
        </components>
     </station>
  </stations>
</drweb-es-api>

 

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

Элемент <stations /> содержит список установленных компонентов на станциях, указанных в запросе.

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

Атрибут

Описание

total

Общее количество станций в ответе

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

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

Атрибут

Описание

id

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

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

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

Атрибут

Описание

total

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

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

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

Атрибут

Описание

code

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

name

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

installed

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

path

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

server

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

 

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

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

    "timestamp": 1589406077,

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

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

      "version": "13.00.0.202005090",
      "uuid": "b35d999d-9212-481d-af8c-8551c4113383"}},

"data": {
    "total": 1,

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

          "name": "Preventive protection",

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

           ...,

          {"code": 154,
          "installed_time": 1589388768,

          "name": "Application Control",

          "path": "C:\\Program Files\\DrWeb",
          "server": ""}],
      "station_id": "1002"}]}}

 

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

Блок data содержит список установленных компонентов на станциях, указанных в запросе.

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

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

Описание

total

Общее количество станций в ответе

list

Массив с информацией обо всех установленных компонентах для каждой станции

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

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

Описание

components

Массив с параметрами для каждого установленного компонента на конкретной станции

station_id

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

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

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

Описание

code

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

installed_time

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

name

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

path

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

server

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