获取空间下群组

更新时间：2024-09-10 01:49:16

本文介绍获取空间下群组的 API。

接口描述

根据空间 ID，获取空间下群组。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
space_id	String	query	true	空间 ID。
page_size	Integer	query	true	分页页面大小。
page_no	Integer	query	true	当前页码。

返回参数

参数名	类型	说明
result	SpaceDeviceGroupDTO	返回数据集。
success	Boolean	操作是否成功。 `true`：操作成功。 `false`：操作失败。
t	Long	时间戳。
tid	String	链路 ID。

result 说明

参数名	类型	说明
dataList	List	数据列表。
count	Integer	总数。
page_size	Integer	每页数量。
pag_number	Integer	当前页码。

dataList 说明

参数名	类型	说明
id	Long	群组 ID。
name	String	群组名称。
pv	String	协议版本。
time	Long	群组创建时间。
type	Integer	分组类型。
uid	String	用户 ID。
group_type	Integer	群组类型。
icon_url	String	群组图片。
local_key	String	`mqtt` 对应的 `localKey`。
owner_id	String	空间 ID。
product_id	String	产品 ID。

请求示例

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

{
  "space_id": "158170***",
  "page_no": 1,
  "page_size": 10
}

返回示例

{
    "tid": "e36ef6c3b32111edaddddda1143bd9",
    "result": {
        "count": 11,
        "page_number": 1,
        "dataList": [
            {
                "icon_url": "https://images.tuyaus.com/smart/solution/15001/66ba22c327bfbf3d_co***.png",
                "standard": false,
                "dp_name": {
                    "1": "",
                    "9": ""
                },
                "local_key": "b74a3d9762a9f***",
                "dps": {
                    "1": false,
                    "9": 0
                },
                "owner_id": "25129***",
                "pv": "2.2",
                "device_num": 2,
                "group_type": 0,
                "type": 0,
                "dev_id": "",
                "product_ver": "1.0.0",
                "product_id": "fqi9xqldlmvpg***",
                "name": "Wi-Fi插座-vdevo 群组",
                "id": 1285211,
                "time": 1676952415,
                "category": "",
                "group_key": ""
            }
        ],
        "page_size": 1
    },
    "t": 1677119365048,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。

上一篇修改群组名称