Получение списка вирусных баз

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

Параметр

Описание

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

id

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

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

да

 

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

http://192.168.1.1:9080/api/stations/bases.ds?id=30cc7eb2-d11d-b211-b695-b80815e63511

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

 

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

<drweb-es-api api_version="4.3.0" timestamp="1559905153" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <stations total="1">
     <station id="724f2e10-890e-11e9-4d9d-6812fd061186">
        <bases total="214">
           <base file_name="dwp11000.vdb" version="1100" created="1559904284" viruses="1"/>

           <base file_name="dwf11000.vdb" version="1100" created="1559904284" viruses="4"/>

          <!-- etc. Skipped in documentation -->

           <base file_name="dwntoday.vdb" version="1100" created="1559904284" viruses="4005"/>
        </bases>
     </station>
  </stations>
</drweb-es-api>

 

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

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

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

Атрибут

Описание

total

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

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

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

Атрибут

Описание

id

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

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

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

Атрибут

Описание

total

Общее количество вирусных баз

Элемент <base /> содержит информацию о конкретной вирусной базе.

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

Атрибут

Описание

file_name

Название файла вирусной базы

version

Версия базы

created

Дата создания базы в формате UNIX timestamp

viruses

Количество вирусных записей в базе

 

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

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

    "timestamp": 1559905392,

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

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

      "version": "12.00.0.201909260",
      "uuid": "6c271cb0-8912-11e9-5a3b-b85a98f7c5ad"}},

"data": {
    "total": 1,

    "list": [
      {"bases": [
          {"created_time": 1559904284,

            "file_name": "dwp11000.vdb",

            "version": "1100",
            "viruses": 1},

          {"created_time": 1559904284,

            "file_name": "dwf11000.vdb",

            "version": "1100",
            "viruses": 4},

         ...

          {"created_time": 1559904284,

            "file_name": "dwntoday.vdb",

            "version": "1100",
            "viruses": 4005}],
        "station_id": "724f2e10-890e-11e9-4d9d-6812fd061186"}]}}

 

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

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

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

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

Описание

total

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

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

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

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

Описание

station_id

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

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

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

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

Описание

created_time

Дата создания базы в формате UNIX timestamp

file_name

Название файла вирусной базы

version

Версия базы

viruses

Количество вирусных записей в базе