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

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

Параметр

Описание

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

id

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

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

да

 

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

http://192.168.1.1:9080/api/stations/products.ds?id=123456789

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

 

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

<drweb-es-api api_version="4.3.0" timestamp="1561465774" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <stations total="1">
    <station id="88e984a0-6031-11e9-5b7e-f4ffebd769bf">
        <products total="4">
          <product code="10-drwbases" modified_time="1560510660" revision="12020190603092307" state_code="S" state="Normal">Вирусные базы Dr.Web</product>

          <product code="10-drwspamdb" modified_time="1560510660" revision="12020190603090829" state_code="F" state="Update failed">Базы Антиспама Dr.Web</product>

          <product code="20-drwagent" modified_time="1560510660" revision="12020190530164458" state_code="S" state="Normal">Агент Dr.Web для Windows</product>

          <product code="10-drwgatedb" modified_time="1560510660" revision="12020190603090829" state_code="F" state="Update failed">Базы SpIDer Gate</product>
        </products>
    </station>
  </stations>
</drweb-es-api>

 

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

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

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

Атрибут

Описание

total

Общее количество станций

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

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

Атрибут

Описание

id

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

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

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

Атрибут

Описание

total

Общее количество продуктов

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

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

Атрибут

Описание

code

Код продукта

modified_time

Дата последнего обновления ревизии в формате Unix timestamp

revision

Номер ревизии

state_code

Код состояния обновления. Может принимать одно из следующих значений:

•D — обновление отложено,

•F — ошибка обновления,

•S — продукт успешно обновлен.

state

Состояние обновления. Может принимать одно из следующих значений:

•Delayed — обновление отложено,

•Update failed — ошибка обновления,

•Normal — продукт успешно обновлен.

 

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

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

    "timestamp": 1561465752,

    "api": {
      "version": 40300,
      "versionString": 4.3.0},

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

      "version": "12.00.0.201909260",
      "uuid": "76b05bc0-8691-11e9-63e5-7036cecd07fa"}}

"data": {
    "total": 1,

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

              "name": "Вирусные базы Dr.Web",

              "revision": 12020190603092307,

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

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

              "name": "Базы SpIDer Gate",

              "revision": 12020190603090829,

              "state": "Update failed",
              "state_code": "F"},

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

              "name": "Базы Антиспама Dr.Web",

              "revision": 12020190603090829,

              "state": "Update failed",
              "state_code": "F"},

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

              "name": "Агент Dr.Web для Windows",

              "revision": 12020190530164458,

              "state": "Normal",
              "state_code": "S"}},
        "station_id": "88e984a0-6031-11e9-5b7e-f4ffebd769bf",
        "total": 4}]}}

 

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

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

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

Название поля

Описание

total

Общее количество станций, информация о которых приведена в ответе

•Массив list содержит информацию о конкретных запрашиваемых станциях.

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

Название поля

Описание

station_id

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

total

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

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

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

Название поля

Описание

modified_time

Дата последнего обновления ревизии в формате Unix timestamp

name

Название продукта

revision

Номер ревизии

state

Состояние обновления. Может принимать одно из следующих значений:

•Delayed — обновление отложено,

•Update failed — ошибка обновления,

•Normal — продукт успешно обновлен.

state_code

Код состояния обновления. Может принимать одно из следующих значений:

•D — обновление отложено,

•F — ошибка обновления,

•S — продукт успешно обновлен.