Get link to web address browsing task report

Expand all | Collapse all

The /sandbox/tasks/url/{task ID}/report/url endpoint is used to obtain the link to download the web address browsing task results.

Request

Request method: GET

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

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:

1. To get a link to an archive that contains task results 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/url?section=all'

2. To download task results (archive) from the received link:

curl.exe -v --http1.1 -k --cert 'full path to the certificate on your computer' --user <user name> 'link to the archive' > <full path and name of the .zip archive where you want to save the task results>

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

451 Unavailable For Legal Reasons

Page top