Get web address browsing task report

Expand all | Collapse all

The /sandbox/tasks/url/{task ID}/report/data endpoint is used to obtain the task results.

Request

Request method: GET

Endpoint: https://tip.kaspersky.com/api/sandbox/tasks/url/{task_id}/report/data

Query parameters:

Expected parameters

Parameter

Description

task_id

Task ID.

section

Array of values separated by commas. Specifies JSON objects to include to the report. Available values:

all—All available JSON files are added to the report (default value).

categories—The categories.json file is added to the report.

detection-names—The detection-names.json file is added to the report.

dns-requests—The dns-requests.json file is added to the report.

hosts-ips—The hosts-ips.json file is added to the report.

http-requests—The http-requests.json file is added to the report.

pcap—The network.pcap file is added to the report.

publications—The publications.json file is added to the report.

screenshots—The <web address>-screenshots.zip file is added to the report.

suspicious-events—The suspicious-events.json file is added to the report.

triggered-network-rules—The triggered-network-rules.json file is added to the report.

url-and-analysis-properties—The url-and-analysis-properties.json file is added to the report.

whois—The WHOIS-ip.json or WHOIS-domain.json file is added to the report.

For more detail about an object execution results in JSON format, refer to section Exporting execution results to JSON archive.

Request example:

To get a task results as a byte stream for the browsed web addresses:

curl -u <user name> --cert <full path to the certificate on your computer> -X GET 'https://tip.kaspersky.com/api/sandbox/tasks/url/<task ID>/report/data?section=all' -o result.zip

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

451 Unavailable For Legal Reasons

Page top