|
Параметры запроса
Параметр
|
Описание
|
Обязательный
|
group-id
|
Идентификатор группы, станции которой будут выведены в ответе
|
нет
|
server-id
|
Идентификатор Сервера Dr.Web, к которому подключены запрашиваемые станции.
По умолчанию — это текущий Сервер Dr.Web.
В качестве Сервера Dr.Web возможно использование подчиненных Серверов Dr.Web, подключенных к данному.
|
нет
|
Пример запроса
https://192.168.1.1:9081/api/stations/states.ds?group-id=6
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.2" timestamp="1587435676" server="192.168.1.1" srv_version="13.00.1.202310121" status="true">
<stations total="4">
<activated total="1"/>
<all total="4"/>
<deinstalled total="1"/>
<deleted total="0"/>
<new total="3"/>
<newbies total="0"/>
<offline total="4"/>
<online total="0"/>
<unactivated total="3"/>
<with_update_errors total="0"/>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию обо всех станциях, соответствующих запросу.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций в ответе
|
•Вложенные элементы элемента <stations />:
Элемент
|
Атрибут
|
Описание
|
<activated />
|
total
|
Количество активированных станций
|
<all />
|
total
|
Общее количество станций в группе, исключая удаленные станции
|
<deinstalled />
|
total
|
Количество станций с удаленным антивирусным программным обеспечением
|
<deleted />
|
total
|
Количество удаленных станций
|
<new />
|
total
|
Количество новых станций с неустановленным антивирусным программным обеспечением
|
<newbies />
|
total
|
Количество станций-новичков (запрашивающих доступ к Серверу Dr.Web)
|
<offline />
|
total
|
Количество станций не в сети
|
<online />
|
total
|
Количество станций в сети
|
<unactivated />
|
total
|
Количество неактивированных станций
|
<with_update_errors />
|
total
|
Количество станций с ошибками обновления антивирусного программного обеспечения
|
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1587435498,
"api": {
"version": 40302,
"versionString": "4.3.2"},
"server": {
"name": "192.168.1.1",
"version": "13.00.1.202310121",
"uuid": "b35d999d-9212-481d-af8c-8551c4113383"}},
"data": {
"states": {
"total": 4,
"activated": 1,
"all": 4,
"deinstalled": 1,
"deleted": 0,
"new": 3,
"newbies": 0,
"offline": 4,
"online": 0,
"unactivated": 3,
"with_update_errors": 0}}}
|
Описание параметров ответного JSON
Блок states, вложенный в блок data, содержит информацию обо всех станциях, соответствующих запросу.
Элементы блока states:
Название поля
|
Описание
|
total
|
Общее количество станций в ответе
|
activated
|
Количество активированных станций
|
all
|
Общее количество станций в группе, исключая удаленные станции
|
deinstalled
|
Количество станций с удаленным антивирусным программным обеспечением
|
deleted
|
Количество удаленных станций
|
new
|
Количество новых станций с неустановленным антивирусным программным обеспечением
|
newbies
|
Количество станций-новичков (запрашивающих доступ к Серверу Dr.Web)
|
offline
|
Количество станций не в сети
|
online
|
Количество станций в сети
|
unactivated
|
Количество неактивированных станций
|
with_update_errors
|
Количество станций с ошибками обновления антивирусного программного обеспечения
|
|