Получение списка станций в группе

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

Параметр

Описание

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

id

Идентификатор группы.

В ответе возвращается информация обо всех станциях заданной группы (без учета вложенности). Возможно получение списка станций для системных групп Operating system, Status, Ungrouped.

да

page

Номер страницы, которую требуется вернуть в ответе при постраничном отображении (может использоваться для вывода информации о большом количестве станций).

По умолчанию: 1.

нет

per-page

Количество станций на одной странице при постраничном отображении (может использоваться для вывода информации о большом количестве станций).

По умолчанию: 100.

нет

server-id

Идентификатор Сервера Dr.Web, с которого запрашивается информация

нет

 

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

https://192.168.1.1:9081/api/groups/stations-list.ds?id=20e27d73-d21d-b211-a788-85419c46f0e6&per-page=2

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

 

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

<drweb-es-api api_version="4.3.0" timestamp="1588849735" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
  <stations total="2">
     <station id="1001" name="1001" last_seen_time="0" last_seen_addr="" state="0" os="0" os_name="unknown" login_addr="" login_mac="" expires="20200427210000000" createtime="20200402120322573" blockbeg="20200428210000000" blockend="20200429215959999"/>

     <station id="1" name="Android SDK built for x865d56" last_seen_time="1588001727" last_seen_addr="tcp://192.168.233.131:49285" state="2" os="17105152" os_name="Android Phone" login_addr="10.3.0.16" login_mac="02:00:00:44:55:66" expires="0" createtime="20200427081641436" blockbeg="0" blockend="0"/>
  </stations>

  <pages total="4" current="1" objects-per-page="2"/>
</drweb-es-api>

 

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

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

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

Атрибут

Описание

total

Общее количество станций заданной группы

▫Элемент <station /> содержит параметры конкретной станции группы.

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

Атрибут

Описание

id

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

name

Название станции

last_seen_time

Время последнего подключения к Серверу Dr.Web

last_seen_addr

Адрес, с которого станция последний раз подключалась к Серверу Dr.Web

state

Текущее состояние станции (см. Приложение Г. Возвращаемые коды состояния станции)

os

Код операционной системы

os_name

Название операционной системы

login_addr

IP-адрес станции

login_mac

MAC-адрес сетевого интерфейса станции

expires

Дата и время окончания допуска клиента. Значение 0 означает неограниченный доступ.

createtime

Дата и время создания станции

blockbeg

Дата и время начала блокировки

blockend

Дата и время окончания блокировки

•Элемент <pages /> содержит информацию о постраничном отображении.

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

Атрибут

Описание

total

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

current

Номер текущей страницы

objects-per-page

Максимальное количество станций на странице

 

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

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

    "timestamp": 1588852235,

    "api": {
      "version": 40300,
      "versionString": 4.3.0},

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

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

"data": {
    "pages": {
      "total": 4,
      "current": 1,

      "objects_per_page": 2},

    "stations": {
      "total": 2,

      "list": [
          {"id": "1001",
          "name": "1001",

          "last_seen_time": 0,

          "last_seen_addr": null,

          "state": 0,

          "os_code": 0,

          "os_name": "unknown",

          "login_addr": null,
          "login_mac": null,

          "createtime": 20200402120322573,

          "blockbeg": 20200428210000000,

          "blockend": 20200429215959999,
          "expires": 20200427210000000},

          {"id": "1",
          "name": "Android SDK built for x865d56",

          "last_seen_time": 1588001727,

          "last_seen_addr": "tcp://10.3.0.16:56247",

          "state": 2,

          "os_code": 17105152,

          "os_name": "Android Phone",

          "login_addr": "10.3.0.16",
          "login_mac": "02:00:00:44:55:66",

          "createtime": 20200427081641436,

          "blockbeg": 0,

          "blockend": 0,
          "expires": 0}]}}}

 

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

•Блок pages содержит информацию о постраничном отображении.

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

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

Описание

current

Номер текущей страницы

objects_per_page

Максимальное количество станций на странице

total

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

•Блок stations содержит список станций в группе, указанной в запросе.

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

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

Описание

total

Общее количество станций заданной группы

list

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

▫Каждый объект массива list содержит параметры конкретной станции заданной группы.

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

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

Описание

id

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

name

Название станции

last_seen_time

Время последнего подключения к Серверу Dr.Web

last_seen_addr

Адрес, с которого станция последний раз подключалась к Серверу Dr.Web

state

Текущее состояние станции (см. Приложение Г. Возвращаемые коды состояния станции)

os_code

Код операционной системы

os_name

Название операционной системы

login_addr

IP-адрес станции

login_mac

MAC-адрес сетевого интерфейса станции

createtime

Дата и время создания станции

blockbeg

Дата и время начала блокировки

blockend

Дата и время окончания блокировки

expires

Дата и время окончания допуска клиента. Значение 0 означает неограниченный доступ.