Get a List of Virus Databases

Request Parameter

Parameter

Description

Mandatory

id

Station ID.

This parameter can be repeated any number of times per request to obtain virus database lists from multiple stations at a time.

yes

 

Request Example

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

XML and JSON response structure examples are described below.

 

XML Response Structure

<drweb-es-api api_version="4.3.0" 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>

 

Description of XML Response Parameters

The <stations /> element contains a list of virus databases on stations specified in the request.

The <stations /> element attribute:

Attribute

Description

total

Total number of stations in a response

The <station /> element contains information about a specific station.

The <station /> element attribute:

Attribute

Description

id

Station ID

The <bases /> element contains information about all virus databases on a station.

The <bases /> element attribute:

Attribute

Description

total

Total number of virus databases on a station

The <base /> element contains parameters of a specific virus database.

The <base /> element attributes:

Attribute

Description

file_name

Virus database file name

version

Virus database version

created

Virus database creation date

viruses

Number of virus records in a database

 

JSON Response Structure

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

    "timestamp": 1582030518,

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

    "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"}]}}

 

Description of JSON Response Parameters

The data block contains a list of virus databases on stations specified in the request.

The data block elements:

Field name

Description

total

Total number of stations in a response

list

Array of parameters for all virus databases on each station

Elements in the list array:

Field name

Description

bases

Array of parameters for each virus database of a specific station

station_id

Station ID

Elements in the bases array:

Field name

Description

created_time

Virus database creation date

file_name

Virus database file name

version

Virus database version

viruses

Number of virus records in a database