下发群组属性

更新时间:2024-06-28 23:13:10下载pdf

本文介绍下发群组属性的 API。

接口描述

根据群组 ID,下发群组属性,即下发控制指令给群组下的设备。

接口地址

POST: /v2.1/cloud/thing/group/{group_id}/properties

请求参数

参数名类型参数位置是否必填说明
group_idLongpathtrue群组 ID。

body 说明

参数名类型参数位置是否必填说明
propertiesStringbodytrue群组属性,即指令集合。

返回参数

参数名类型说明
resultJsonObject返回群组数据结果。
successBooleanAPI 调用是否成功。
  • true:调用成功。
  • false:调用失败。
tLong时间戳。
tidString链路 ID。

result 说明

参数名类型说明
resultBoolean操作是否成功。
  • true:操作成功。
  • false:操作失败。

请求示例

POST: /v2.1/cloud/thing/group/1393****/properties
{
  "properties": "{\"work_mode\":\"music\", \"switch_led\": true}"
}

返回示例

{
    "tid": "4ab1341e022111efbe7a366d87620758",
    "result": {
        "result": true
    },
    "t": 1713952748467,
    "success": true
}

错误码

参考 错误码

调用频率限制

更多信息,参考 调用频率限制