|
Параметр запроса
Параметр
|
Описание
|
Обязательный
|
id
|
Идентификатор станции.
Параметр может быть указан в запросе неограниченное количество раз для получения информации о нескольких станциях одновременно.
|
да
|
Пример запроса
https://192.168.1.1:9081/api/stations/newbies-info.ds?id=1e98b5e0-5166-11ea-410d-fc78713e8b1f
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.2" timestamp="1582030264" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
<stations total="1">
<station id="1e98b5e0-5166-11ea-410d-fc78713e8b1f" name="win7-pro-x86-ru" created="1581930965" parent_id="20e27d73-d21d-b211-a788-85419c46f0e6" parent_name="Everyone" state="0">
<os code="33753095">Windows 7 Professional x86</os>
<server>aa5520b0-4e4f-11ea-6061-94d96b90100f</server>
<address>tcp://192.168.1.1:57516</address>
</station>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию о станциях-новичках.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций в ответе
|
•Элемент <station /> содержит параметры конкретной станции-новичка.
Атрибуты элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
name
|
Название станции
|
created
|
Дата создания учетной записи станции на Сервере Dr.Web
|
parent_id
|
Идентификатор родительской группы
|
parent_name
|
Название родительской группы
|
state
|
Текущие состояние станции (см. Приложение Г. Возвращаемые коды состояния станции)
|
▫Элемент <os /> содержит информацию об операционной системе, которая установлена на станции.
Атрибут элемента <os />:
Атрибут
|
Описание
|
code
|
Код операционной системы
|
Значение элемента <os /> — название операционной системы.
▫Значение элемента <server /> — идентификатор Сервера Dr.Web, к которому запрашивает подключение станция.
▫Значение элемента <address /> — сетевой адрес, с которого станция последний раз обращалась к Серверу Dr.Web.
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1582030521,
"api": {
"version": 40302,
"versionString": "4.3.2"},
"server": {
"name": "192.168.1.1",
"version": "13.00.0.202005090",
"uuid": "eae1a652-96d5-48fd-9169-4788a03688b8"}},
"data": {
"total": 1,
"list": [{
"address": "tcp://192.168.1.1:40566",
"created_time": 1581930965,
"id": "1e98b5e0-5166-11ea-410d-fc78713e8b1f",
"name": "win7-pro-x86-ru",
"onconnect": 0,
"os_code": 33753095,",
"os_name": "Windows 7 Professional x86",
"parent_id": "20e27d73-d21d-b211-a788-85419c46f0e6",
"parent_name": "Everyone",
"server": "aa5520b0-4e4f-11ea-6061-94d96b90100f",
"state": 0}]}}
|
Описание параметров ответного JSON
Блок data содержит информацию обо всех станциях-новичках.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций в ответе
|
list
|
Массив с информацией о каждой станции-новичке
|
•Каждый объект массива list содержит информацию о конкретной станции-новичке.
Элементы объектов в массиве list:
Название поля
|
Описание
|
address
|
Сетевой адрес, с которого станция последний раз обращалась к Серверу Dr.Web
|
created_time
|
Дата создания учетной записи станции на Сервере Dr.Web
|
id
|
Идентификатор станции
|
name
|
Название станции
|
onconnect
|
Действие, которое будет выполнено при следующем подключении станции к Серверу Dr.Web:
0 — ничего не будет выполнено,
1 — доступ к Серверу Dr.Web для новичка будет запрещен,
2 — доступ к Серверу Dr.Web для новичка будет разрешен.
|
os_code
|
Код операционной системы
|
os_name
|
Название операционной системы
|
parent_id
|
Идентификатор родительской группы
|
parent_name
|
Название родительской группы
|
server
|
Идентификатор Сервера Dr.Web, к которому запрашивает подключение станция
|
state
|
Текущие состояние станции (см. Приложение Г. Возвращаемые коды состояния станции)
|
|