Получение информации о продуктах на станции

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

Параметр

Описание

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

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

Параметр может быть указан в запросе неограниченное количество раз для получения информации о продуктах на нескольких станциях одновременно.

да

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

https://192.168.1.1:9081/api/stations/products.ds?id=1002

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

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

<drweb-es-api api_version="4.3.2" timestamp="1587645254" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
<stations total="1">
<station id="1002">
<products total="4">
<product code="10-drwbases" modified_time="1587620547" revision="13020200416235234" state_code="S" state="Normal state">Dr.Web virus databases</product>

<product code="10-drwgatedb" modified_time="1587620547" revision="13020200417001112" state_code="S" state="Normal state">SpIDer Gate databases</product>

<product code="10-drwspamdb" modified_time="1587620547" revision="13020200416220812" state_code="S" state="Normal state">Dr.Web Anti-spam databases</product>

<product code="20-drwagent" modified_time="1587620547" revision="13020200415153408" state_code="S" state="Normal state">Dr.Web Agent for Windows</product>
</products>
</station>
</stations>
</drweb-es-api>

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

Элемент <stations /> содержит информацию обо всех продуктах на станциях, указанных в запросе.

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

Атрибут	Описание
total	Общее количество станций в ответе

•Элемент <station /> содержит информацию о конкретной станции.

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

Атрибут	Описание
id	Идентификатор станции

▫Элемент <products /> содержит информацию обо всех продуктах на станции.

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

Атрибут	Описание
total	Общее количество продуктов на станции

▪Элемент <product /> содержит информацию о конкретном продукте.

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

Атрибут	Описание
code	Код продукта
modified_time	Дата последнего обновления ревизии
revision	Номер ревизии
state_code	Код состояния обновления: •D — обновление отложено, •F — ошибка обновления, •S — продукт успешно обновлен.
state	Состояние обновления: •Delayed — обновление отложено, •Update failed — ошибка обновления, •Normal state — продукт успешно обновлен.

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

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

"timestamp": 1587647090,

"api": {
"version": 40302,
"versionString": "4.3.2"},

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

"version": "13.00.0.202005090",
"uuid": "6d8f5aa0-850a-11ea-4c3c-c8efa441e4dd"}}

"data": {
"total": 1,

"list": [
{"products": {
"10-drwbases": {
"modified_time": "1587620547",

"name": "Dr.Web virus databases",

"revision": 13020200416235234,

"state": "Normal state",
"state_code": "S"},

"10-drwgatedb": {
"modified_time": "1587620547",

"name": "SpIDer Gate databases",

"revision": 13020200417001112,

"state": "Normal state",
"state_code": "S"},

"10-drwspamdb": {
"modified_time": "1587620547",

"name": "Dr.Web Anti-spam databases",

"revision": 13020200416220812,

"state": "Normal state",
"state_code": "S"},

"20-drwagent": {
"modified_time": "1587620547",

"name": "Dr.Web Agent for Windows",

"revision": 13020200415153408,

"state": "Normal state",
"state_code": "S"}},
"station_id": "1002",
"total": 4}]}}

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

Блок data содержит информацию обо всех продуктах на станциях, указанных в запросе.

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

Название поля	Описание
total	Общее количество станций в ответе
list	Массив с информацией о продуктах для каждой станции

•Каждый объект массива list содержит информацию о продуктах конкретной станции.

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

Название поля	Описание
products	Блок параметров для каждого продукта на станции
station_id	Идентификатор станции
total	Общее количество продуктов на станции

▫Блок products состоит из вложенных блоков.

▪Каждый вложенный блок содержит параметры конкретного продукта. Название вложенного блока соответствует коду продукта в репозитории.

Элементы вложенных блоков в блоке products:

Название поля	Описание
modified_time	Дата последнего обновления ревизии
name	Название продукта
revision	Номер ревизии
state	Состояние обновления: •Delayed — обновление отложено, •Update failed — ошибка обновления, •Normal — продукт успешно обновлен.
state_code	Код состояния обновления: •D — обновление отложено, •F — ошибка обновления, •S — продукт успешно обновлен.