|
Параметр запроса
Параметр
|
Описание
|
Обязательный
|
id
|
Идентификатор станции.
Параметр может быть указан в запросе неограниченное количество раз для получения информации о продуктах на нескольких станциях одновременно.
|
да
|
Пример запроса
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.1.202310121" 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-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.1.202310121",
"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-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 — продукт успешно обновлен. |
|