Получение снимков экрана
16 июля 2026
ID ObtainingScreenshotsAPI
Kaspersky Research Sandbox предоставляет API для получения архива tar.gz, содержащего набор снимков экрана (изображений PNG), сделанных во время выполнения файла.
Перед выполнением этого запроса убедитесь, что требуемая задача не удалена.
В команде cURL используйте подробный режим (-v).
В случае ошибки запроса архив tar.gz будет пустым с простым текстовым файлом, содержащим сообщение об ошибке.
Запрос
Метод запроса: GET
Конечная точка: https://<server name>/api/v1/sandbox/tasks/{task ID}/screens/archive
Параметры
Получение снимков экрана
Параметр | Тип данных | Вхождение | Описание |
|---|---|---|---|
| строка | Обязательно | Идентификатор задачи выполнения объекта (GUID). |
Пример команды cURL: $ curl -v --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/screens/archive' --output <tar.gz archive name> Вам будет предложено ввести пароль. Пароль не отображается во время ввода. |
Ответы
Конечная точка возвращает архив tar.gz, содержащий набор снимков экрана.
200 OK
Архив со снимками экрана успешно получен.
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
Не удалось получить архив со снимками экрана из-за внутренней ошибки сервера.
