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

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

Параметр

Описание

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

id

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

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

да

 

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

https://192.168.1.1:9081/api/stations/bases.ds?id=1001&id=1002

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

 

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

<drweb-es-api api_version="4.3.2" timestamp="1582030261" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
  <stations total="2">
     <station id="1001">
        <bases total="185">
           <base file_name="dwp11000.vdb" version="1100" created="1581930715" viruses="1"/>

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

           <base file_name="dwmtoday.vdb" version="1100" created="1581930715" viruses="5507"/>
        </bases>
     </station>

     <station id="1002">
        <bases total="185">
           <base file_name="dwp11000.vdb" version="1100" created="1581930715" viruses="1"/>

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

           <base file_name="dwmtoday.vdb" version="1100" created="1581930715" viruses="5507"/>
        </bases>
     </station>
  </stations>
</drweb-es-api>

 

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

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

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

Атрибут

Описание

total

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

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

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

Атрибут

Описание

id

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

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

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

Атрибут

Описание

total

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

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

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

Атрибут

Описание

file_name

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

version

Версия базы

created

Дата создания базы

viruses

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

 

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

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

    "timestamp": 1582030518,

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

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

      "version": "13.00.0.202005090",
      "uuid": "eae1a652-96d5-48fd-9169-4788a03688b8"}},

"data": {
    "total": 2,

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

            "file_name": "dwp11000.vdb",

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

         ...

          {"created_time": 1581930715,

            "file_name": "dwmtoday.vdb",

            "version": "1100",
            "viruses": 5507}],
        "station_id": "1001"},

      {"bases": [
          {"created_time": 1581930715,

            "file_name": "dwp11000.vdb",

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

         ...

          {"created_time": 1581930715,

            "file_name": "dwmtoday.vdb",

            "version": "1100",
            "viruses": 5507}],
        "station_id": "1002"}]}}

 

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

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

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

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

Описание

total

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

list

Массив параметров для всех вирусных баз для каждой станции

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

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

Описание

bases

Массив с параметрами для каждой вирусной базы конкретной станции

station_id

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

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

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

Описание

created_time

Дата создания базы

file_name

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

version

Версия базы

viruses

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