查询期望属性

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

本文介绍查询期望属性的 API。

接口描述

根据设备 ID,查询设备的期望属性设置列表。

接口地址

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

请求参数

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

返回参数

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

result 说明

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

properties 说明

参数名类型说明
dpIdInteger属性 ID。
codeString属性 code。
valueObject属性值。
expire_timeLong过期时间。
statusInteger属性的推送状态。
  • 0:未推送。
  • 1:已推送。
timeLong属性的设置时间。

请求示例

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

返回示例

{
    "result": {
        "properties": [
            {
                "code": "switch_led",
                "dpId": 20,
                "expire_time": 1678427008528,
                "time": 1669797124390,
                "value": false,
                "status": 1
            }
        ]
    },
    "t": 1675393820827,
    "success": true
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制