平台提供设备命令API,用于直接向设备下发单播指令
API为同步设计,即,当设备收到命令并进行应答时,API返回设备应答内容
POST /v1/synccmds?device_id=524092364&timeout=30
<command-content>
版本 | 类型 | 是否必须 | 说明 |
---|---|---|---|
device_id | string | 是 | 设备ID |
timeout | string | 是 | 同步API最长等待时间,取值范围 5-30, 单位秒 |
请求body部分为用户自定义命令数据内容
Content-type: application/json
{
"errno": 0,
"error": "success",
"data": {
"cmd_uuid": "f9115090-8ef1-4b0c-aaf4-0678754f575a",
"cmd_resp": "dGhpcyUyMGlzJTIwY29tbWFuZC1yZXNwb25zZSUyMGNvbnRlbnQ="
}
}
参数名称 | 类型 | 说明 |
---|---|---|
errno | int | 错误码 |
error | string | 错误描述 |
cmd_uuid | string | 命令ID |
cmd_resp | string | 设备应答内容,base64编码格式 |
错误码 | 错误描述 | 说明 |
---|---|---|
12 | device not found | 设备不存在 |
13 | device not online | 设备不在线 |
14 | cmd response timeout | 设备命令应答超时 |
返回错误示例:
{
"errno": 14,
"error": "cmd response timeout"
}