Get Installed Components List

Request Parameters

Parameter

Description

Obligatory

id

Station identifier.

This parameter can be defined in the request several times to get installed components lists for several stations at a time.

yes

 

Request Example

http://192.168.1.1:9080/api/stations/installed-components.ds?id=88e984a0-6031-11e9-5b7e-f4ffebd769bf

XML and JSON response structure examples are described below.

 

XML Response

<drweb-es-api api_version="4.3.0" timestamp="1561552101" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <stations total="1">
     <station id="88e984a0-6031-11e9-5b7e-f4ffebd769bf">
        <components total="10">
           <component code="144" name="Dr.Web Preventive Protection" installed="1559729080" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="4" name="Dr.Web Scanner for Windows" installed="1561445724" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="14" name="SpIDer Mail for Windows workstations" installed="1561445724" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="30" name="Dr.Web Agent for Windows" installed="1561445694" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="37" name="Dr.Web Agent Scanner for Windows" installed="1561445694" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="38" name="SpIDer Gate for Windows workstations" installed="1561445696" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="54" name="Dr.Web Office Control" installed="1561445723" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="55" name="Dr.Web Antispam" installed="1561445690" path="C:\Program Files\DrWeb" server="MT"/>

           <component code="57" name="SpIDer Guard for Windows workstations" installed="1561445724" path="C:\Windows\system32\drivers\" server="tcp/192.168.10.93:2193"/>

           <component code="124" name="Dr.Web Self-protection" installed="1561445725" path="C:\Windows\system32\drivers\" server="tcp/192.168.10.93:2193"/>
        </components>
     </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 <components /> element contains information on all installed components of a specific station.

The <components /> element attribute:

Attribute

Description

total

Total number of components installed on this station

The <component /> element contains information about a specific installed component.

The <component /> element attributes:

Attribute

Description

code

Digital code of the component (see the Component codes section)

name

Name of the component (see the Component codes section)

installed

Date of the component installation in the UNIX timestamp format

path

Component installation path

server

Address of the Server from which the component was installed. For components installed from the current Server, the server attribute contains the empty value.

 

JSON Response

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

    "timestamp": 1561552119,

    "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": [{
      "components": [
          {"code": 144,
          "installed_time": 1559729080,

          "name": "Dr.Web Preventive Protection",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 4,
          "installed_time": 1561445724,

          "name": "Dr.Web Scanner for Windows",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 14,
          "installed_time": 1561445724,

          "name": "SpIDer Mail for Windows workstations",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 30,
          "installed_time": 1561445694,

          "name": "Dr.Web Agent for Windows",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 37,
          "installed_time": 1561445694,

          "name": "Dr.Web Agent Scanner for Window",

          "path": "C:\\Program Files\\DrWeb",
          "server": "tcp/192.168.1.1:2193"},

          {"code": 38,
          "installed_time": 1561445696,

          "name": "SpIDer Gate for Windows workstations",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 54,
          "installed_time": 1561445723,

          "name": "Dr.Web Office Control",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 55,
          "installed_time": 1561445690,

          "name": "Dr.Web Antispam",

          "path": "C:\\Program Files\\DrWeb",
          "server": "MT"},

          {"code": 57,
          "installed_time": 1561445724,

          "name": "SpIDer Guard for Windows workstations",

          "path": "C:\\Windows\\system32\\drivers\\",
          "server": "tcp/192.168.10.93:2193"},

          {"code": 124,
          "installed_time": 1561445725,

          "name": "Dr.Web Self-protection",

          "path": "C:\\Windows\\system32\\drivers\\",
          "server": "tcp/192.168.10.93:2193"}],
      "station_id": "88e984a0-6031-11e9-5b7e-f4ffebd769bf"}]}}

 

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 components array contains information on all installed components of a station.

Elements in the components array:

Field name

Description

code

Digital code of the component (see the Component codes section)

installed_time

Date of the component installation in the UNIX timestamp format

name

Name of the component (see the Component codes section)

path

Component installation path

server

Address of the Server from which the component was installed. For components installed from the current Server, the server attribute contains the empty value.