创建群组

更新时间：2024-06-28 23:53:31下载pdf

本文介绍创建群组的 API。

接口描述

创建 Wi-Fi 群组。需要是相同品类，同一空间下的设备集合。

接口地址

POST: /v2.0/cloud/thing/group

请求参数

body 说明

参数名	类型	参数位置	是否必填	说明
space_id	String	body	true	空间 ID。
name	String	body	true	群组名称。
product_id	String	body	true	产品 ID。
device_ids	String	body	true	设备 ID 集合，多个设备 ID 使用逗号分隔。设备数量不可超过 20。

返回参数

参数名	类型	说明
result	DeviceGroupCloudDTO	返回群组数据结果。
success	Boolean	操作是否成功。 `true`：操作成功。 `false`：操作失败。
t	Boolean	时间戳。
tid	Boolean	链路 ID。

result 说明

参数名	类型	说明
id	Long	群组 ID。
name	String	群组的名称数据。
pv	String	MQTT 协议版本。
time	Long	群组创建时间。
type	Integer	群组的分组类型。 `0`：直连云设备。 `1`：非直连云设备，需要通过网关设备连云的设备。
uid	String	群组所属的用户 ID。
group_type	Integer	群组所属的协议类型。 `0`：Wi-Fi `1`：蓝牙低功耗 `2`：Zigbee `3`：蓝牙 mesh
icon_url	String	群组的图片信息，默认是产品的图片。目前不支持更改。
local_key	String	`mqtt` 对应的 `localKey`。
owner_id	String	群组所属的空间的 ID 数据。
product_id	String	群组的产品 ID。

请求示例

POST: /v2.0/cloud/thing/group

{
  "space_id": "25129******",
  "name": "测试群组**",
  "product_id": "dsadhsjkh2312",
  "device_ids": "dshajhdkhaj***,hsdkajhkk***"
}

返回示例

{
    "tid": "22b76e4eb71211edabe5e6670becb070",
    "result": {
        "local_key": "93fda9e167da***",
        "pv": "2.2",
        "group_type": 0,
        "type": 0,
        "product_id": "fqi9xqldl****",
        "name": "测***",
        "id": 1286611,
        "time": 1677552405152
    },
    "t": 1677552405220,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。