Request Parameters
Parameter
|
Description
|
Valid values
|
Mandatory
|
id
|
Station identifier.
This parameter can be defined in the request several times to launch the scan on several stations at a time.
|
-
|
yes
|
type
|
Scan type. Default is quick.
|
•full—full scan, •quick—quick scan. |
no
|
action-infected-files
|
Action on infected files detection
|
•cure, •delete, •quarantine—move to quarantine. |
no
|
action-suspicious-files
|
Action on suspicious files detection
|
•ignore, •delete, •quarantine—move to quarantine. |
no
|
action-incurable-files
|
Action when infected object cannot be cured
|
•delete, •quarantine—move to quarantine. |
no
|
action-infected-container
|
Action on infected files containers detection
|
no
|
action-infected-archive
|
Action on infected archives detection
|
no
|
action-infected-mail
|
Action on infected e-mail files detection
|
•ignore, •quarantine—move to quarantine. |
no
|
action-infected-boot
|
Action on infected boot sectors detection
|
•report—send notification to the Server, •cure. |
no
|
action-adware
|
Action on adware detection
|
•ignore, •delete, •quarantine—move to quarantine. |
no
|
action-dialers
|
Action on dialers detection
|
no
|
action-jokes
|
Action on joke programs detection
|
no
|
action-riskware
|
Action on riskware detection
|
no
|
action-hacktools
|
Action on hacktools detection
|
no
|
reboot
|
Set automatic reboot of a user computer after the scan is completed if during the check infected objects detected and the cure process requires reboot of operating system.
|
yes | no
|
no
|
Request Example
http://192.168.1.1:9080/api/stations/start_scanner.ds?id=d071625c-d21d-b211-9bc4-bc02713bf843&id=70200e02-d21d-b211-8a39-a00ca2f8be36
Response Documents Structure
•XML response. •JSON response. XML Response Structure
<drweb-avdesk-api api_version="4.1.3" timestamp="1391508276" server="192.168.1.1" srv_version="10.01.0.201707130" status="true">
<stations total="2">
<station id="d071625c-d21d-b211-9bc4-bc02713bf843" status="failed"/>
<station id="70200e02-d21d-b211-8a39-a00ca2f8be36" status="initiated"/>
</stations>
</drweb-avdesk-api>
|
Description of XML Response Parameters
•The <stations /> element contains information on a result of scan launch at stations. The <stations /> element attributes:
Attribute
|
Description
|
total
|
Number of stations with launched scan
|
▫The <station /> element contains information on specific stations on which remote scan is launched. The <station /> element attributes:
Attribute
|
Description
|
id
|
Station identifier
|
status
|
The state of scan remote launch. May take the following values:
•delayed—scan launch is delayed, •failed—scan launch is failed, •initiated—scan is initiated. |
JSON Response Structure
{"head": {
"status": true,
"timestamp":1392279301,
"api":{
"version":40103},
"server":{
"name":"192.168.1.1",
"version":1000201707130,
"uuid": "a509dab1-d423-4059-971a-aa3944a2c48a"}},
"data":{
"results": {
"success" : ["d071625c-d21d-b211-9bc4-bc02713bf843" ],
"fail": [ ]}}}
|
Description of JSON Response Parameters
The results block contains information on a result of scan launch at stations.
The results block elements:
Field name
|
Description
|
success
|
Contains array with identifiers of stations on which remote scan is successfully initiated
|
fail
|
Contains array with identifiers of stations on which remote scan is failed
|
|