修改属性

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

本文介绍修改属性的 API。

接口描述

根据设备 ID,修改设备上报到云端的属性状态。目前只开放修改属性自定义名称。

接口地址

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

请求参数

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

body 说明

参数名类型参数位置是否必填说明
propertiesList true设备属性对象列表。

properties 说明

参数名类型参数位置是否必填说明
codeString true属性 code。
custom_nameString true属性自定义名称。

返回参数

参数名类型说明
resultBoolean返回结果。
  • true:操作成功。
  • false:操作失败。

请求示例

POST: /v2.0/cloud/thing/372817193*****/shadow/properties
{
  "properties": [
    {
      "code": "switch_led",
      "custom_name": "switch_led1"
    }
  ]
}

返回示例

{
    "result": true,
    "t": 1591872112140,
    "success": true
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制