获取设备规格属性

更新时间：2023-06-20 15:21:49下载pdf

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

接口描述

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

接口地址

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

请求参数

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

返回参数

参数名	类型	说明
result	FunctionStatusToLangRes

result 说明

参数名	类型	说明
category	String	产品品类
status	List	标准状态集
functions	List	标准功能集

functions 说明

参数名	类型	说明
code	String	指令集Code
type	String	指令集类型
name	String	指令集名称
values	String	指令集取值描述
lang_config	Map<String,String>	多语言描述配置

status 说明

参数名	类型	说明
code	String	状态集Code
type	String	状态集类型
name	String	状态集名称
values	String	状态集取值描述
lang_config	Map<String,String>	多语言描述配置

请求示例

GET: /v1.2/iot-03/devices/****id/specification

返回示例

{
    "result": {
        "functions": [
            {
                "code": "switch",
                "values": "{}",
                "lang_config": {
                    "false": "关闭",
                    "true": "开启"
                },
                "type": "Boolean",
                "name": "开关"
            },
            {
                "code": "temp_set",
                "values": "{\"unit\":\"℃\",\"min\":0,\"max\":37,\"scale\":0,\"step\":1}",
                "lang_config": {
                    "unit": "°C"
                },
                "type": "Integer",
                "name": "目标温度"
            }
        ],
        "category": "qn",
        "status": [
            {
                "code": "switch",
                "values": "{}",
                "lang_config": {
                    "false": "关闭",
                    "true": "开启"
                },
                "type": "Boolean",
                "name": "开关"
            },
            {
                "code": "temp_set",
                "values": "{\"unit\":\"℃\",\"min\":0,\"max\":37,\"scale\":0,\"step\":1}",
                "lang_config": {
                    "unit": "°C"
                },
                "type": "Integer",
                "name": "目标温度"
            },
            {
                "code": "temp_current",
                "values": "{\"unit\":\"℃\",\"min\":-20,\"max\":50,\"scale\":0,\"step\":1}",
                "lang_config": {
                    "unit": "°C"
                },
                "type": "Integer",
                "name": "当前温度"
            }
        ]
    },
    "t": 1639022337569,
    "success": true
}

错误码

参考错误码。