云服务 API 参考设备高级服务垂直品类硬件 API行业三方设备能力公区通用能力公区设备指令指令记录查询

指令记录查询

更新时间：2023-06-20 14:54:08

本文介绍指令记录查询的 API。

接口描述

根据下发设备指令返回的指令记录 ID，查询设备侧指令执行的结果。

接口地址

GET: /v1.0/expand/cmds/{sn}

请求参数

参数名	类型	参数位置	是否必填	说明
sn	String	uri	true	指令记录 ID

返回参数

参数名	类型	说明
result	CmdIssueResponse	响应结果

result 说明

参数名	类型	说明
sn	String	指令记录 ID
happen_time	Long	指令执行时间
message	String	指令执行描述
device_id	String	涂鸦设备 ID
process_status	Integer	指令执行状态 1:指令发送中 2:已发送 3:执行成功 4:执行失败 5:指令执行状态未知

请求示例

GET: /v1.0/expand/cmds/133****

返回示例

{
    "result": {
        "device_id": "6ce****",
        "happen_time": 1591693362843,
        "message": "指令已发送",
        "process_status": 2,
        "sn": "133****"
    },
    "t": 1551851043862,
    "success": true
}

错误码

参考错误码。