Получение информации о загруженных файлах

Kaspersky Research Sandbox предоставляет API для получения информации о файлах, которые были загружены выполняемым объектом.

Запрос

Метод запроса: GET

Конечная точка: https://<server name>/api/v1/sandbox/tasks/{task ID}/downloads

Параметры

Получение информации о загруженных файлах

Параметр	Тип данных	Вхождение	Описание
`task_id`	строка	Обязательно	Идентификатор задачи выполнения объекта (GUID).

Пример команды cURL:

$ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/downloads'

Вам будет предложено ввести пароль. Пароль не отображается во время ввода.

Ответы

Конечная точка возвращает объект JSON, содержащий информацию о загруженных файлах.

200 OK

Информация о загруженных файлах получена успешно.

Параметры ответа 200 OK

Параметр	Тип данных	Описание
`Zone`	строка	Уровень опасности загруженного файла (например, Red).
`Md5`	строка	MD5-хеш загруженного файла.
`Sha1`	строка	SHA1-хеш загруженного файла.
`Sha256`	строка	SHA256-хеш загруженного файла.
`DetectionNames`	массив	Название обнаруженного объекта (например, Trojan-Downloader.Script.Generic).
`Name`	строка	Название загруженного файла (например, sample.exe).
`Size`	целое число	Размер загруженного файла (в байтах).
`Type`	строка	Тип загруженного файла.
`IsHttpsTraffic`	логический	Указывает, является ли трафик, из которого были извлечены загруженные файлы, HTTPS-трафиком.
`TriggeredYaraRules`	массив	Список сработавших правил YARA.

Пример ответа 200 OK:

{

"Zone": "Grey",

"Md5": "string",

"Sha1": "string",

"Sha256": "string",

"DetectionNames": [],

"Name": "string",

"Size": 0,

"Type": "string",

"IsHttpsTraffic": false,

"TriggeredYaraRules": []

}

400 Bad Request

Не удалось получить информацию о загруженных файлах из-за некорректного запроса.

Параметры ответа 400 Bad Request

Параметр	Тип данных	Описание
`code`	строка	Идентификатор ошибки.
`message`	строка	Описание ошибки.
`meta`	строка	Дополнительная информация, если таковая имеется.

Примеры ошибок:

Неверный параметр task_id:

{"code":6,"message":"task not found"}

Неверный формат параметра task_id:

{"code":29,"message":"bad task id"}

401 Unauthorized

Не удалось получить информацию о загруженных файлах из-за неверных учетных данных пользователя.

404 Not Found

Задача с указанным идентификатором не найдена.

500 Internal Server Error

Не удалось получить информацию о загруженных файлах из-за внутренней ошибки сервера.