Получение результатов задачи песочницы
16 июля 2026
ID ObtainingSandboxTaskResultsAPI
Kaspersky Research Sandbox предоставляет API для получения результатов выполнения задач песочницы. Информацию об ограничениях для сокращенных отчетов см. в разделе Сокращенные (краткие) отчеты для файлов.
Запрос
Метод запроса: GET
Конечная точка: https://<server name>/api/v1/sandbox/tasks/{task ID}/report
Параметры
Параметры получения результатов выполнения задачи
Параметр | Тип данных | Вхождение | Описание |
|---|---|---|---|
| строка | Обязательно | Идентификатор задачи выполнения объекта (GUID), результаты которой требуется получить. |
| строка | Обязательно | Формат отчета. Доступные значения:
Значение по умолчанию: |
| строка | Необязательно | Формат отчета о классификации MITRE ATT&CK. Доступные значения:
Значение по умолчанию: |
Пример команды cURL: $ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/report' Вам будет предложено ввести пароль. Пароль не отображается во время ввода. |
Ответы
Конечная точка возвращает результаты выполнения задачи в указанном формате.
200 OK
Результаты задачи песочницы получены успешно.
Подробное описание содержимого файла см. в разделах Экспорт результатов выполнения в архив JSON и Экспорт результатов выполнения в архив CSV.
Если вы запрашиваете только результаты статического анализа (pre_scan=true), ответ содержит следующую информацию:
- параметры файла и его выполнения;
- результаты статического анализа;
- обнаруженные объекты (при наличии);
- содержимое, если выполняемый объект является контейнером.
Обратите внимание, что в текущей версии Kaspersky Research Sandbox файлы loaded-pe-images.json и loaded-pe-images.csv переименованы в loaded-images.json и loaded-image.csv соответственно.
400 Bad Request
Не удалось получить результаты задачи песочницы из-за неверного запроса.
Параметры ответа 400 Bad Request
Параметр | Тип данных | Описание |
|---|---|---|
| строка | Идентификатор ошибки. |
| строка | Описание ошибки. |
| строка | Дополнительная информация, если таковая имеется. |
Примеры ошибок: Неверный параметр {"code":6,"message":"task not found"} Неверный формат параметра {"code":29,"message":"bad task id"} |
401 Unauthorized
Не удалось получить результаты задачи песочницы из-за неверных учетных данных пользователя.
404 Not Found
Задача с указанным идентификатором не найдена.
500 Internal Server Error
Не удалось получить результаты задачи песочницы из-за внутренней ошибки сервера.