Параметры запроса
Параметр
|
Описание
|
Обязательный
|
id
|
Идентификатор станции.
Параметр может быть указан в запросе неограниченное количество раз для получения информации о нескольких станциях одновременно.
|
да
|
Пример запроса
http://192.168.1.1:9080/api/stations/newbies-info.ds?id=d034621d-7405-e711-1491-f4600dec4700
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="<%API_V%>" timestamp="1558521955" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<stations total="1">
<station id="d034621d-7405-e711-1491-f4600dec4700" name="36fz1ya27aQ" created="1489138192" parent_id="20e27d73-d21d-b211-a788-85419c46f0e6" parent_name="Everyone" state="0">
<os code="35850244">Windows 7 Enterprise x64</os>
<server>70d9cc8c-6df7-e611-1c76-f030d2090f68</server>
<address>tcp://192.168.1.1:57516</address>
</station>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию о станциях-новичках.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций, информация о которых приведена в ответе
|
•Элемент <station /> содержит информацию о конкретной станции-новичке. Атрибуты элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
name
|
Название станции
|
created
|
Дата создания учетной записи станции на Сервере
|
parent_id
|
Идентификатор родительской группы
|
parent_name
|
Имя родительской группы
|
state
|
Текущие состояние станции (см. в разделе Возвращаемые коды состояния станции)
|
▫Элемент <os /> содержит информацию об операционной системе, которая установлена на станции. Атрибут элемента <os />:
Атрибут
|
Описание
|
code
|
Код операционной системы
|
Значение элемента <os /> — название операционной системы.
▫Значение элемента <server /> — идентификатор Сервера, к которому запрашивает подключение станция. ▫Значение элемента <address /> — сетевой адрес, с которого станция последний раз обращалась к Серверу.
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1558522043,
"api": {
"version": 40300,
"versionString": 4.3.0},
"server": {
"name": "192.168.1.1",
"version": "12.00.0.201909260",
"uuid": "27671337-e0b0-4f60-aeb0-ab1f2ca47f77"}},
"data": {
"total": 1,
"list": [{
"address": "tcp://192.168.1.1:40566",
"created_time": 1489138192,
"id": "1a299c6c-5b5c-4089-a72b-3044752d52b7",
"name": "elena.i.drweb.ru",
"onconnect": 2,
"os_code": 16842752,
"os_name": "Linux",
"parent_id": "20e27d73-d21d-b211-a788-85419c46f0e6",
"parent_name": "Everyone",
"server": "257f112d-ab07-4d17-ae01-f37b6b135fab",
"state": 0}]}}
|
Описание параметров ответного JSON
Блок data содержит информацию обо всех станциях-новичках.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций, информация о которых приведена в ответе
|
•Массив list содержит информацию о каждой конкретной станции-новичке. Элементы объектов в массиве list:
Название поля
|
Описание
|
address
|
Cетевой адрес, с которого станция последний раз обращалась к Серверу
|
created_time
|
Дата создания учетной записи станции на Сервере
|
id
|
Идентификатор станции
|
name
|
Название станции
|
onconnect
|
Действие, которое будет выполнено при следующем подключении станции к Серверу:
0 — ничего не будет выполнено,
1 — доступ к Серверу для новичка будет запрещен,
2 — доступ к Серверу для новичка будет разрешен.
|
os_code
|
Код операционной системы
|
os_name
|
Название операционной системы
|
parent_id
|
Идентификатор родительской группы
|
parent_name
|
Имя родительской группы
|
server
|
Идентификатор Сервера, к которому запрашивает подключение станция
|
state
|
Текущие состояние станции (см. в разделе Возвращаемые коды состояния станции)
|
|