查询属性

更新时间：2024-06-29 01:24:12下载pdf

本文介绍查询属性的 API。

接口描述

根据设备 ID，查询设备上报到云端的属性状态。

接口地址

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 说明

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

请求示例

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

返回示例

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

错误码

参考错误码。

调用频率限制

参考调用频率限制。

上一篇下发属性

下一篇修改属性