Rescan a web address browsing task

Expand all | Collapse all

The /sandbox/tasks/url endpoint is used to repeat a web address browsing in Kaspersky Sandbox>.

Request

Request method: POST

Endpoint: https://tip.kaspersky.com/api/sandbox/tasks/url

Query parameters:

Expected parameters

Parameter

Description

url

Web address that you want to browse.

Required parameter. Use percent-encoding (URL encoding) to convert certain characters into a valid ASCII format.

exec_env

Operating system that you want to use as a browsing environment. Available values:

Win7_x64—Microsoft Windows 7 x64.

Win7—Microsoft Windows 7 x86.

Win10_x64—Microsoft Windows 10 x64.

Default value: Win10_x64.

exec_time

Web address emulation time in seconds.

Available values: 30500.

Default value: 100.

decrypt_https

Boolean parameter. Specifies whether HTTPS traffic generated by the executed object must be decrypted. Available values:

true—HTTPS traffic generated by the object is decrypted.

false—HTTPS traffic generated by the object is not decrypted.

The HTTPS traffic decryption may decrease the malware detection probability.

By default, decrypt_https = true.

channel

Region or individual country of a network channel that the object uses to access the Internet. There are individual countries among the regions through which the executed file can access the Internet.

Use the api/sandbox/channels method to obtain all available values.

Parameter values are case-sensitive.

Description of available values:

TOR—Internet channel belongs to any region and directs traffic through the TOR network.

Tarpit—File is executed without access to the Internet.

<region or country name>—Internet channel belongs to any region and does not direct traffic through the TOR network (for example, RU, US, GB).

Request example:

Browse web address:

curl -u <user name> --cert <full path to the certificate on your computer> -X POST --header 'Content-Length: 0' 'https://tip.kaspersky.com/api/sandbox/tasks/url?url=ya.ru'

Responses

200 OK

401 Unauthorized

403 Forbidden

451 Unavailable For Legal Reasons

Page top