Kaspersky Research Sandbox provides an API to obtain information about the content (extracted files) of the executed packed object (container).
Request
Request method: GET
Endpoint: https://<server name>/api/v1/sandbox/tasks/{task ID}/container_files
Parameters
Obtaining information about container's content
Parameter |
Data type |
Occurrence |
Description |
---|---|---|---|
|
string |
Required |
Object execution task ID (GUID). |
cURL command sample: $ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/container_files' You will be asked to enter your password. The password is not displayed while you type it. |
Responses
Endpoint returns a JSON object that contains information about the extracted files of the executed packed object (container).
200 OK
Information about the contents of the container is obtained successfully.
200 OK response parameters
Parameter |
Data type |
Description |
---|---|---|
|
string |
Danger level of the file (for example, Red). |
|
string |
MD5 hash function of the file. |
|
string |
SHA1 hash of the file. |
|
string |
SHA256 hash of the file. |
|
string |
File name and path from the root of the uploaded object. |
|
string |
Name of the packer used to pack the uploaded object. |
|
string |
Automatically detected file type. |
|
array |
Name of the detected object (for example, Trojan-Downloader.Script.Generic). |
200 OK response example: { "Zone": "Grey", "MD5": "string", "Sha1": "string", "Sha256": "string", "Path": "string", "Packer": "string", "Type": "string", "DetectionNames": [] } |
400 Bad Request
Failed to obtain information about the contents of the container due to incorrect query.
400 Bad Request response parameters
Parameter |
Data type |
Description |
---|---|---|
|
string |
Error ID. |
|
string |
Error description. |
|
string |
Additional information, if available. |
Error examples: Incorrect {"code":6,"message":"task not found"} Incorrect {"code":29,"message":"bad task id"} |
401 Unauthorized
Failed to obtain information about the contents of the container.
404 Not Found
Task with specified ID not found.
500 Internal Server Error
Failed to obtain information about the contents of the container due to an internal server error.
Page top