Use the hub_url received in the registration response as your base URL.
This API requires the device to authenticate, see Device Authentication.
Get a command to be executed from the server.
If the response received from the Send Telemetry API has the command field set to true, the device must call this API to get details on the command to be executed from the server.
Multiple commands might be queued. The device requests one command at a time, calling this API again as needed after each command is completed. Upon completion of each command, it notifies the server by calling the Update Command API.
Return Data
Name | Type | Description | Model API Version | |
---|---|---|---|---|
id | integer | ID of command to be executed | 1.0.1+ | |
device_id | string | Device ID | 1.0.7+ | |
status | string | Current command status: _ pending _ in_progress | 1.0.1+ | |
name | string | Command name | 1.0.1+ | |
parameters | object | Parameters for the command | 1.0.1+ | |
name | string / number / boolean / object | Custom parameters for each command | 1.0.1+ |
Return Sample
{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx",
"device_id": "fbe103c8-...",
"status": "pending",
"name": "update_firmware",
"parameters": {
"url": "https://s3.amazonaws.com/xxxx.zip",
"version": "1.3.4"
}
}
NOTE: The command id should be saved locally; it is needed to update the server when the device has successfully executed the command.
Optional Commands to Support
The following standard commands can be enabled automatically when a model is created on the Xyte platform. In this case, all devices of that model type will need to implement these commands:
Name | Description |
---|---|
reboot | Reboot device |
dump | Create dump report |