设置期望属性

更新时间：2024-11-14 09:55:56下载pdf

本文介绍设置期望属性的 API。

接口描述

将设备属性下发指令存储在云端。当设备被唤醒 / 上线时，将指令下发到设备。该功能目前仅面向部分低功耗设备有效。

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

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

body 说明

参数名	类型	参数位置	是否必填	说明
properties	String	body	true	设备支持的属性信息和设置的属性值。
duration	Long	body	true	数据有效期，单位是秒。
type	Integer	body	false	期望属性设置类型。如果此参数未填，则是默认模式。 `0`：设备主动拉取模式，需设备主动调用 API，来查询设置的期望属性。 `1`：默认模式，设备上线时，云端将设置的属性推送给设备。

POST: /v2.0/cloud/thing/vdevo1638******/shadow/properties/desired

{
  "properties": "{\"switch_1\":true}",
  "duration": 1000
}

{
    "tid": "77a9807fb74411edb9d75a827c79edfd",
    "result": {
    },
    "t": 1677574021435,
    "success": true
}