查询命令状态
请求方式:GET
URL:http://api.heclouds.com/cmds/cmd_uuid
cmd_uuid:需要被替换为命令ID
HTTP请求返回参数
参数名称 |
格式 |
说明 |
errno |
int |
调用错误码,为0表示调用成功 |
error |
string |
错误描述,为"succ"表示调用成功 |
data |
json |
接口调用成功之后返回的命令状态信息,见data描述表 |
data描述表
参数名称 |
格式 |
说明 |
status |
int |
命令状态,见命令状态说明 |
desc |
string |
状态描述 |
命令状态说明
状态值 |
状态描述 |
常见场景 |
1 |
命令已创建 Command Created |
设备离线,调用发送命令API,带有timeout参数时 |
2 |
命令已发往设备 Command Sent |
设备在线,但是未做命令应答时 |
4 |
设备正常响应 Command Response Received |
设备接收到命令且正常发送命令响应 |
请求示例
GET http://api.heclouds.com/cmds/81572aae-fc34-5deb-8f06-ab45d73cb12b HTTP/1.1
返回示例1:成功创建命令但设备未在线
{
"errno": 0,
"data": {
"status": 1,
"desc": "command created"
},
"error": "succ"
}
返回示例2:设备正常响应
{
"errno": 0,
"data": {
"status": 4,
"desc": "Command Response Received"
},
"error": "succ"
}