Get Logs v3.0
| API version | 3.0 |
|---|---|
| Last Update | 04/25/2017 |
| Authentication | YES |
| HTTP Method | POST |
| Content Type | application/json |
| Rate limited | YES |
| Requests per rate limit | 10/min |
| Response Format | JSON |
MetaAccess records events on your accounts. There are 2 types of event logs: admin event logs and device event logs. To retrieve event logs on your account, you can use this API. You can set filters in parameters to filter event logs you concern.
API URL
Request Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| access_token | string | URL | Yes | access token which archived from OAuth authentication step | |
| limit | int | Body | Optional | Specific maximum number of event logs will be returned in the response. The value should be in [1,50]. If there are more event logs than what the limit asks for, error code will be 406. Event logs in response is ordered by date. | 20 |
| page | int | Body | Optional | Specific page number which event logs will be returned in. If the requested page exceeds the number of pages of event logs, error code will be 413. It means that the requested page number is too large, no devices will be returned in this case. | 1 |
| start_date | string | Body | Optional | Specific the start date for the query duration. Starting date of the query. Format: YYYY/MM/DD | |
| end_date | string | Body | Optional | Specific the end date for the query duration. Format: YYYY/MM/DD | |
| age | int | Body | Optional | Specify age of the information in seconds. Maximum value is 86400 (1 day) For example: if you want to query event logs in last 5 minutes, you need to pass age as 300. | |
| filter | array<string> | Body | Optional | Specify which events you want to retrieve. Options can be:
|
Response HTTP Code
See APIs
Response Parameters
| Key | DataType | Description |
|---|---|---|
| logs | array<object> | Lists of event logs |
| logs.timestamp | string | timestamp when the event log occurs |
| logs.event | string | Event text |
| logs.device_id | string | HWID of the device which the event occurred on |
| logs.device_name | string | Device name which the event occurred on |
| logs.mac_addresses | string | MAC address of the device which the event occurred on |
| logs.details | array<string> | Event details. The format is: ["category", "application", "version", "status"] |
Example
Example Request
Example Response
History
| Version | URL |
|---|---|
| v2.0 | Get Logs v2.0 |
Was this page helpful?