Параметры запроса
Параметр
|
Описание
|
Обязательный
|
group-id
|
Идентификатор группы, станции которой будут выведены в ответе
|
нет
|
server-id
|
Идентификатор Dr.Web Сервера, к которому подключены запрашиваемые станции.
По умолчанию — текущий Сервер. В качестве Сервера возможно использование подчиненных Серверов, подключенных к данному.
|
нет
|
Пример запроса
http://192.168.1.1:9080/api/stations/states.ds?group-id=6
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.0" timestamp="1558521952" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<stations total="59">
<all total="55"/>
<newbies total="0"/>
<deinstalled total="0"/>
<online total="0"/>
<activated total="1"/>
<new total="54"/>
<unactivated total="54"/>
<with_update_errors total="0"/>
<offline total="55"/>
<deleted total="4"/>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию обо всех станциях из запрошенной группы.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций в группе
|
Вложенные элементы элемента <stations />:
Элемент
|
Атрибут
|
Описание значения элемента
|
<all />
|
total
|
Общее количество станций в группе, исключая удаленные станции
|
<newbies />
|
total
|
Количество станций-новичков (запрашивающих доступ к Серверу)
|
<deinstalled />
|
total
|
Количество станций с удаленным антивирусным ПО
|
<online />
|
total
|
Количество станций в сети
|
<activated />
|
total
|
Количество активированных станций
|
<new />
|
total
|
Количество новых станций с неустановленным антивирусным ПО
|
<unactivated />
|
total
|
Количество неактивированных станций
|
<with_update_errors />
|
total
|
Количество станций с ошибками обновления антивирусного ПО
|
<offline />
|
total
|
Количество станций не в сети
|
<deleted />
|
total
|
Количество удаленных станций
|
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1558522040,
"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": {
"states": {
"activated": 1,
"all": 55,
"deinstalled": 0,
"deleted": 4,
"new": 54,
"newbies": 0,
"offline": 4 ,
"online": 1,
"total": 59,
"unactivated": 54,
"with_update_errors": 0}}}
|
Описание параметров ответного JSON
Блок states содержит информацию обо всех станциях из запрошенной группы.
Элементы блока states:
Название поля
|
Описание
|
activated
|
Количество активированных станций
|
all
|
Общее количество станций в группе, исключая удаленные станции
|
deinstalled
|
Количество станций с удаленным антивирусным ПО
|
deleted
|
Количество удаленных станций
|
new
|
Количество новых станций с неустановленным антивирусным ПО
|
newbies
|
Количество станций-новичков (запрашивающих доступ к Серверу)
|
offline
|
Количество станций не в сети
|
online
|
Количество станций в сети
|
total
|
Общее количество станций в группе
|
unactivated
|
Количество неактивированных станций
|
with_update_errors
|
Количество станций с ошибками обновления антивирусного ПО
|
|