Preparation
Follow First steps toward using the API and take note of the following:
- Authentication Token
- Trend Vision One API Regional Domain
- You may either use the desktop or web version of Postman.
- Download OpenAPI specification
- Import the OpenAPI specification in Postman.
Click the image to enlarge.
- Under Collections, go to Authorization tab then enter your Authentication Token.
Click the image to enlarge.
- Click Variables tab and modify the "Current value" of baseUrl with your Trend Vision One API Regional Domain.
Click the image to enlarge.
- Click Save.
GET request
Example: List suspicious objects from Threat Intelligence- On Params tab, enter the values for the query parameters:
Click the image to enlarge.
- On Headers tab, enter the value for the header parameter:
Click the image to enlarge.
- Click Send.
POST request
Example: Add suspicious objects to Threat Intelligence- On Body tab, enter the values for the request body schema:
Click the image to enlarge.
- Click Send.
- Install the required Python packages.
- pip install requests
- pip install ldap3
- Update the values of url_base and token.
GET requests
Example: List suspicious objects from Threat Intelligence- On the query_params section, update the values of the parameters.
Click the image to enlarge.
- Run the script.
POST requests
Example: Add suspicious objects to Threat Intelligence- On the body section, update the values of the parameters
Click the image to enlarge.
- Run the script.
| HTTP status code | Error Code | Problem | Cause |
|---|---|---|---|
| 401 Unauthorized | InvalidCredentials or InvalidToken | The authentication token is invalid | The authentication token or the API Regional Domain included with the API request is wrong |
| 403 Forbidden | AccessDenied | The authentication token is valid but not allowed to do an action or access a resource | The role assigned to the API key does not have the necessary permissions for the resource or the operation |
| 404 Not Found | NotFound | A request tries to access a resource but the resource is not found | The resource no longer exists |