查询属性

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

本文介绍查询属性的 API。

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备 ID。
codesStringqueryfalse属性 code 集合,以逗号分隔。

返回参数

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

result 说明

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

properties 说明

参数名类型说明
codeString属性 code。
timeLong属性值的更新时间戳。
valueObject属性值。
custom_nameString自定义名称。
dp_idInteger属性 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
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制