Device Statistics
| API version | 2.0 |
|---|---|
| Last Update | 09/21/2014 |
| Authentication | YES |
| Response Format | JSON |
| HTTP Method | GET |
| Rate limited | YES |
| Requests per rate limit | 10/min |
Use to statistic devices which added/not seen in past X hours.
API URL
Request Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| access_token | string | URL | Yes | access token which archived from OAuth authentication step | |
| event | Yes | Specific what devices want to statistic Values are supported
| |||
| opt | int | URL | optional | Specify which type of the value in "devices" key will be returned in the response Values: 0 - MAC address or 1 - HWID or 3 - SSID | 0 |
| in | int | URL | optional | Query duration in second/hour/month/year which specified in "period" parameter. This parameter needs to go along with "period" parameter. For example: query devices in the last month
| |
| period | string | URL | optional | Time unit of the query duration in "in" parameter, which will be used for the calculation. Values: second, hour, month, ytd | |
| start_date | datetime | URL | optional | Starting date of the query duration. Format: YYYYMMDD (in UTC timezone). This parameter needs to go along with end_date parameter. | |
| end_date | datetime | URL | optional | Ending date of the query duration. Format: YYYYMMDD (in UTC timezone) For example: query devices from a date to a date (ex: from 10/01/2016 to 11/01/2016)
| |
| device_type | string | URL | optional | Values: all , managed, unmanaged | all |
Response HTTP Code
Response Parameters
| Key | Datatype | Description |
|---|---|---|
| total_count | int | Number of total devices |
| devices | array<string> | Lists of devices which added/have not checked in/has out-of-date agent. Values in the array can be mac address, hardware id or SSID based on the "opt" parameter |
Example
Example Request:
Example Response
Was this page helpful?