云服务 API 参考IoT Core连接服务设备控制设备控制（标准指令集）获取设备规格属性

获取设备规格属性

更新时间：2023-11-23 06:09:33下载pdf

本文介绍获取设备规格属性的 API。

接口描述

根据设备 ID 获取设备规格属性，包含指令集和状态集。

接口地址

GET: /v1.0/iot-03/devices/{device_id}/specification

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID

返回参数

参数名	类型	说明
result	FunctionStatusRes

result 说明

参数名	类型	说明
category	String	产品品类
functions	List	指令集
status	List	状态集

functions 说明

参数名	类型	说明
name	String	指令名称
desc	String	描述
code	String	指令
type	String	指令类型
values	String	指令入参范围

status 说明

参数名	类型	说明
code	String	状态码
name	String	状态名称
type	String	类型
values	String	入参范围

请求示例

GET: /v1.0/iot-03/devices/xxxid/specification

返回示例

{
    "result": {
        "functions": [
            {
                "code": "switch",
                "values": "{}",
                "type": "Boolean",
                "name": "开关",
                "desc": "{}"
            }
        ],
        "category": "dj",
        "status": [
            {
                "code": "switch_led",
                "values": "{}",
                "type": "Boolean",
                "name": "开关"
            }
        ]
    },
    "t": 1591872112140,
    "success": true
}

错误码

参考错误码。

上一篇下发指令