获取空间下群组

更新时间:2023-12-07 03:33:56下载pdf

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

接口描述

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

接口地址

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

请求参数

body 说明

参数名类型参数位置是否必填说明
space_idStringbodytrue空间 ID。
page_sizeIntegerbodytrue分页页面大小。
page_noIntegerbodytrue当前页码。

返回参数

参数名类型说明
resultSpaceDeviceGroupDTO返回数据集。
successBoolean操作是否成功。
  • true:操作成功。
  • false:操作失败。
tLong时间戳。
tidString链路 ID。

result 说明

参数名类型说明
dataListList数据列表。
countInteger总数。
page_sizeInteger每页数量。
pag_numberInteger当前页码。

dataList 说明

参数名类型说明
idLong群组 ID。
nameString群组名称。
pvString协议版本。
timeLong群组创建时间。
typeInteger分组类型。
uidString用户 ID。
group_typeInteger群组类型。
icon_urlString群组图片。
local_keyStringmqtt 对应的 localKey
owner_idString空间 ID。
product_idString产品 ID。

请求示例

GET: /v2.0/cloud/thing/group
{
  "space_id": "158170***",
  "page_no": 1,
  "page_size": 10
}

返回示例

{
    "tid": "e36ef6c3b32111edaa2fba12a1143bd9",
    "result": {
        "count": 11,
        "page_number": 1,
        "dataList": [
            {
                "icon_url": "https://images.tuyacn.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
}

错误码

参考 错误码