获取空间下群组

更新时间：2024-06-29 02:30:11下载pdf

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

接口描述

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

接口地址

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

请求参数

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

返回参数

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

result 说明

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

data_list 说明

参数名	类型	说明
group_id	Long	群组 ID。
group_name	String	群组名称。
space_id	String	群组所属空间的 ID。
icon_url	String	群组 Icon 信息，入参产品对应图片。
create_time	Long	群组创建时间。
update_time	Long	群组更新时间。

请求示例

GET: /v2.1/cloud/thing/group?page_no=1&page_size=10&space_id=16702****

返回示例

{
    "tid": "3d9023fc021911efbe7a366d87620758",
    "result": {
        "data_list": [
            {
                "icon_url": "https://images.tuyacn.com/smart/solution/142004/673976648441****.png",
                "create_time": 1713944885,
                "group_name": "testUpdateGroup****",
                "update_time": 1713944885,
                "group_id": "1393****",
                "space_id": "16702****"
            }
        ],
        "count": 1,
        "page_no": 1,
        "page_size": 10
    },
    "t": 1713949290836,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。

上一篇查询群组属性