查询群组设备

更新时间：2024-06-29 02:18:03下载pdf

本文介绍查询群组设备的 API。

接口描述

根据群组 ID，查询群组下的设备。

接口地址

GET: /v2.1/cloud/thing/group/{group_id}/devices

请求参数

参数名	类型	参数位置	是否必填	说明
group_id	Long	path	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。
device_id	String	设备 ID。
create_time	Long	群组与设备关系建立的时间。
update_time	Long	群组与设备关系更新的时间。

请求示例

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

返回示例

{
    "tid": "e4d2d4b1022111efbe7a366d87620758",
    "result": {
        "data_list": [
            {
                "create_time": 1713944885103,
                "device_id": "vdevo17059963185****",
                "update_time": 1713944885103,
                "group_id": "1393****"
            },
            {
                "create_time": 1713949980073,
                "device_id": "vdevo17059988536****",
                "update_time": 1713949980073,
                "group_id": "1393****"
            },
            {
                "create_time": 1713944885355,
                "device_id": "vdevo17059963113****",
                "update_time": 1713944885355,
                "group_id": "1393****"
            }
        ],
        "count": 3,
        "page_no": 1,
        "page_size": 10
    },
    "t": 1713953006944,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。

上一篇删除群组

下一篇修改群组信息