下发属性

更新时间:2023-11-23 06:18:41下载pdf

本文介绍下发属性的 API。

接口描述

根据设备 ID,立即向该设备下发属性设置指令。当设备不在线时,下发会失败。

接口地址

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

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备 ID。

body 说明

参数名类型参数位置是否必填说明
propertiesStringbodytrue设备支持的属性信息。数据为 JSON 可解析,key 是属性code,value 是下发设备属性的值。

返回参数

参数名类型说明
resultJSON返回业务数据结果,目前下发无结果。
successBoolean操作是否成功。
  • true:操作成功。
  • false:操作失败。
tLong时间戳。
tidString链路 ID。

请求示例

POST: /v2.0/cloud/thing/372817193*****/shadow/properties/issue
{
  "properties": {
    "switch_1": true
  }
}

返回示例

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

错误码

参考 错误码

调用频率限制

参考 调用频率限制