查询属性

更新时间：2023-12-07 03:33:51

本文介绍查询属性的 API。

接口描述

查询在云端存储的设备上报的属性最新值。

接口地址

GET: /v2.0/cloud/thing/{device_id}/shadow/properties

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID。
codes	String	query	false	属性 code 集合，以逗号分隔。

返回参数

参数名	类型	说明
result	Object	返回结果。

result 说明

参数名	类型	说明
properties	List	属性列表。

properties 说明

参数名	类型	说明
dpId	Integer	属性 ID。
code	String	属性 code。
time	Long	更新时间戳。
value	Object	属性值。
custom_name	String	自定义名称。

请求示例

GET: /v2.0/cloud/thing/372817193*****/shadow/properties

返回示例

{
    "result": {
        "properties": [
            {
                "code": "switch_led",
                "dpId": 20,
                "custom_name": "cole_red",
                "time": 1669797124390,
                "value": true
            }
        ]
    },
    "t": 1675393820827,
    "success": true
}

错误码

参考错误码。