Devices Action v2.0
| API version | 2.0 |
|---|---|
| Last Update | 01/12/2015 |
| Authentication | YES |
| Response Format | JSON |
| HTTP Method | POST |
| Rate limited | YES |
| Requests per rate limit | 10/min |
Use to send a remote command to given devices
API URL
Request Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| access_token | string | URL | Yes | access token which archived from OAuth authentication step | |
| opt | int | Body | Optional | 0 - MAC address 1 - HWID | 0 |
| types | string | Body | Yes | The action type: dhcprenew - renew ip address for network interfaces on devices. exempt_all - exempt devices. unexempt - unexempt devices. | |
| MAC_list | array<string> | Body | Optional | MAC addresses of devices you want to send remote command. \ The request body must have MAC_list parameter or HWID_list parameter, but not both. | |
| HWID_list | array<string> | Body | Optional | HWIDs of devices you want to send remote command. _The request body must have MAC_list parameter or HWID_list parameter, but not both._ |
Response HTTP Code
| HTTP Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad request |
| 401 | Unauthorized. Your access_token is invalid or expired |
| 404 | Not found |
Response Parameters
| Key | DataType | Description |
|---|---|---|
| result | array<int> | The result of batch action. Result[i] value means that the action on device[i] is
|
Note: reasons can cause failure
the cloud couldn't find any devices which reports the given MAC address or HWID
the given MAC address is invalid
Example
Example Request
Example Response
Was this page helpful?