Get States of Stations

Request Parameters

Parameter

Description

Mandatory

group-id

Identifier of a group stations of which will be given in the response

no

server-id

Identifier of the Dr.Web Server to which stations are connected.

The current Server is by default. You can use neighbor Servers connected to this Server.

no

 

Request Example

http://192.168.1.1:9080/api/stations/states.ds?group-id=6

XML and JSON response structure examples are described below.

 

XML Response

<drweb-es-api api_version="4.3.0" timestamp="1558521952" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <stations total="59">
     <all total="55"/>

     <newbies total="0"/>

     <deinstalled total="0"/>

     <online total="0"/>

     <activated total="1"/>

     <new total="54"/>

     <unactivated total="54"/>

     <with_update_errors total="0"/>

     <offline total="55"/>
     <deleted total="4"/>
  </stations>
</drweb-es-api>

 

Description of XML Response Parameters

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

The <stations /> element attribute:

Attribute

Description

total

Total number of stations in the group

The <stations /> element elements:

Element

Attribute

Description of element value

<all />

total

Total number of stations in the group except deleted stations

<newbies />

total

Number of newbies (which request the access to the Server)

<deinstalled />

total

Number of stations with uninstalled antivirus software

<online />

total

Number of online stations

<activated />

total

Number of activated stations

<new />

total

Number of new stations with not installed antivirus software

<unactivated />

total

Number of unactivated stations

<with_update_errors />

total

Number of stations with errors of antivirus software updates

<offline />

total

Number of offline stations

<deleted />

total

Number of deleted stations

 

JSON Response

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

    "timestamp": 1558522040,

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

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

       "version": "12.00.0.201909260",
       "uuid": "27671337-e0b0-4f60-aeb0-ab1f2ca47f77"}},

 "data": {
    "states": {
       "activated": 1,
       "all": 55,

       "deinstalled": 0,

       "deleted": 4,

"new": 54,

       "newbies": 0,

       "offline": 4 ,

       "online": 1,

       "total": 59,

       "unactivated": 54,

       "with_update_errors": 0}}}

 

Description of JSON Response Parameters

The states block contains information on all stations from the requested group.

The states block elements:

Field name

Description

activated

Number of activated stations

all

Total number of stations in the group except deleted stations

deinstalled

Number of stations with uninstalled antivirus software

deleted

Number of deleted stations

new

Number of new stations with not installed antivirus software

newbies

Number of newbies (which request the access to the Server)

offline

Number of offline stations

online

Number of online stations

total

Total number of stations in the group

unactivated

Number of unactivated stations

with_update_errors

Number of stations with errors of antivirus software updates