Получение информации о файлах дампа
16 июля 2026
ID ObtainingDumpInfoAPI
Kaspersky Research Sandbox предоставляет API для получения информации о файлах дампа (снимках) процесса выполнения файлов и загруженных модулей.
Этот метод доступен только для объектов, которые были выполнены в среде выполнения мобильной операционной системы (Android).
Запрос
Метод запроса: GET
Конечная точка: https://<server name>/api/v1/sandbox/tasks/{task ID}/dumps
Параметры
Получение информации о файлах дампа
Параметр | Тип данных | Вхождение | Описание |
|---|---|---|---|
| строка | Обязательно | Идентификатор задачи выполнения объекта (GUID). |
Пример команды cURL: $ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/dumps' Вам будет предложено ввести пароль. Пароль не отображается во время ввода. |
Ответы
Конечная точка возвращает объект JSON, содержащий информацию о файлах дампа.
200 OK
Информация о файлах дампа получена успешно.
Параметры ответа 200 OK
Параметр | Тип данных | Описание |
|---|---|---|
| строка | Уровень опасности файла дампа (например, Red). |
| строка | MD5-хеш файла дампа. |
| строка | SHA1-хеш файла дампа. |
| строка | SHA256-хеш файла дампа. |
| массив | Название обнаруженного объекта (например, HEUR:Exploit.Script.Blocker). |
| строка | Имя файла дампа (например, sample.exe). |
| целое число | Размер файла дампа (в байтах). |
| строка | Тип файла дампа. |
| логический | Указывает, был ли обнаружен HTTPS-трафик. |
| массив | Список сработавших правил 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":6,"message":"task not found"} Неверный формат параметра {"code":29,"message":"bad task id"} |
401 Unauthorized
Не удалось получить информацию о файлах дампа из-за неверных учетных данных пользователя.
404 Not Found
Задача с указанным идентификатором не найдена.
Пример ошибки: Параметр {"code":35, "message":"task section not found"} |
500 Internal Server Error
Не удалось получить информацию о файлах дампа из-за внутренней ошибки сервера.