Example of an HTTP request to scan a local file

March 5, 2024

ID 193002

Protocol version 3.0

The following example shows an HTTP request to scan a local file:

POST /api/v3.0/scanfile HTTP/1.0

Content-Type: application/octet-stream

Content-Length: 22

 

{

"timeout": "10000",

"object": "\/home\/user\/eicar"

}

In the object field, only one object can be specified.

See also the description of all possible fields in the request body and recommendations on how to increase the detection rate.

The following block shows the corresponding response:

HTTP/1.0 200 OK

Connection: close

Content-Type: text/plain

Server: KAVHTTPD/1.0

X-KAV-ProtocolVersion: 3

Date: Wed, 30 Jan 2019 15:46:29 GMT

Content-Length: 75

 

{

"object": "\/home\/user\/eicar",

"scanResult": "DETECT",

"detectionName": "EICAR-Test-File"

}

See also the description of all possible fields in the response body.

Protocol version 3.1

The format of the request is the same, but the response has additional fields.

Did you find this article helpful?
What can we do better?
Thank you for your feedback! You're helping us improve.
Thank you for your feedback! You're helping us improve.