Get Virus Databases List

Request Parameters

Parameter

Description

Obligatory

id

Station identifier.

This parameter can be defined in the request several times to get the lists of virus databases for several stations at a time.

yes

 

Request Example

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

XML and JSON response structure examples are described below.

 

XML Response

<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>

 

Description of XML Response Parameters

The <stations /> element contains information on all requested stations.

The <stations /> element attribute:

Attribute

Description

total

Total number of stations information on which is displayed in response

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

The <station /> element attribute:

Attribute

Description

id

Station identifier

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

The <bases /> element attribute:

Attribute

Description

total

Total number of virus databases

The <base /> element contains information about a specific virus database.

The <base /> element attributes:

Attribute

Description

file_name

Virus database file name

version

Database version

created

Database creation date in the UNIX timestamp format

viruses

The number of virus records in the database

 

JSON Response

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

 

Description of JSON Response Parameters

The data block contains information on all requested stations.

The data block elements:

Field name

Description

total

Total number of stations information on which is displayed in response

The list array contains information on all requested stations.

Elements in the list array:

Field name

Description

station_id

Station identifier

The bases block contains information about all virus databases installed on a specific station.

Elements in the bases array:

Field name

Description

created_time

Database creation date in the UNIX timestamp format

file_name

Virus database file name

version

Database version

viruses

The number of virus records in the database