Get Reports
| API version | 3.1 |
|---|---|
| Last Update | 08/02/2019 |
| Authentication | YES |
| Response Format | CSV | ZIP | JSON |
| HTTP Method | GET |
| Rate limited | YES |
| Requests per rate limit | 10/min |
| Change History | 08/02/2019: add one more export type (type parameter in request), scan_threats_log |
Use to download reports such as OS patches summary, devices which missing a specific OS patch, missing OS patches on a specific device, My OPSWAT Central Management agent log
API URL
Request Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| access_token | string | URL | Yes | access token which archived from OAuth authentication step | |
| type | string | URL | Yes | Specify what report you want to download. Values can be:
| |
| command_id | string | URL | Optional | Must be passed in if the report type is agent_log or scan_threat_log Command ID which archived from Device Action when you request to retrieve OPSWAT Agent logs | |
| kb | string | URL | Optional | Must be passed in with if the report type is device_missing_os_patch KB Number of an OS patch you would like to download devices which are missing the OS patch. | |
| id | string | URL | Optional | Must be passed in if the report type is missing_os_patch Device ID or D MAC address |
Response HTTP Code
See details in the Response HTTP Code section in this page
Response Parameters
| Key | Datatype | Description |
|---|---|---|
| status | string | *Only applied for agent_log, *_scan_threats_log type _ Command status. Value can be
|
| message | string | *_This is applied for agent_log type or *_scan_threats_log type Detailed status |
| error | string | *_This is applied for agent_log type or *_scan_threats_log type Indicate what is wrong |
| error_description | string | *_This is applied for agent_log type or *_scan_threats_log type Detailed error |
Example
GET OS Patches Summary Report
Request Example
Example Response: csv file
| No. | Category | KB Number | Title | Description | Product | Vendor | Severity | No. of Devices |
|---|---|---|---|---|---|---|---|---|
| 1 | critical_update | KB3115040 | Update for Microsoft Project 2013 32-Bit Edition | Microsoft has released an update for Microsoft Project 2013 32-Bit Edition. | Office 2013 | Microsoft Corporation | unknown | 1 |
| 2 | critical_update | KB3115039 | Update for Microsoft OneDrive for Business 32-Bit Edition | Microsoft has released an update for Microsoft OneDrive for Business 32-Bit Edition. | Office 2013 | Microsoft Corporation | unknown | 1 |
GET Devices Which Missing a Specific OS Patch Report
Request Example
Response Example: csv file
| KB Number: KB3115040 | |||
|---|---|---|---|
| Title: Update for Microsoft Project 2013 32-Bit Edition | |||
| No. | Device ID | Device Name | Username |
| 1 | 3AD89B1F7647455889897B5D2A63D15A | WSEVN20 | bob |
GET Missing OS Patches on Device
Request Example
Response Example: csv file
| Last information updated: May 04, 2016 03:23:13 AM UTC | |||||||
|---|---|---|---|---|---|---|---|
| No. | Category | KB Number | Title | Description | Product | Vendor | Severity |
| 1 | update | KB3013816 | Update for Windows 8.1 for x64-based Systems | Install this update to resolve issues in Windows | Windows 8.1 | Microsoft Corporation | unknown |
GET Fetch Log Reports
Request Example
Response Example:
Successful
- HTTP 200
- Response: a zip file. It contains OPSWAT Agent's logs
Command ID is valid but agent log is not available
- HTTP 202
- Response: json
- Command is invalid or doesn't exist
- HTTP 404
- Response: json
GET Scan Threats Reports
Request Example
Response Example:
Successful
- HTTP 200
- Response: a zip file. It contains OPSWAT Agent's threat scanning logs
Command ID is valid but scan threat log is not available
- HTTP 202
- Response: json
- Command is invalid or doesn't exist
- HTTP 404
- Response: json
