查询群组设备

更新时间:2024-09-10 01:49:17

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

接口描述

根据群组 ID,查询群组下设备。

接口地址

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

请求参数

参数名类型参数位置是否必填说明
group_idLongpathtrue群组 ID。
page_sizeIntegerquerytrue每页数量。
page_noIntegerquerytrue当前页码。

返回参数

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

result 说明

参数名类型说明
countInteger总数。
page_sizeInteger每页数量。
page_numberInteger当前页码。
data_listList群组下设备数据列表。

data_list 说明

参数名类型说明
group_idString群组 ID。
dev_idString设备 ID。
statusBoolean设备在群组中的状态。
  • true:有效。
  • false:无效。
display_orderInteger设备排序。
gmt_createLong设备创建时间。
gmt_modifiedLong设备修改时间。

请求示例

GET: /v2.0/cloud/thing/group/12856***/devices
{
  "page_size": 1,
  "page_no": 1
}

返回示例

{
    "tid": "798a754bb31f11edaa2fba12a1143bd9",
    "result": {
        "data_list": [
            {
                "gmt_create": 1677118001658,
                "display_order": 1,
                "gmt_modified": 1677118001658,
                "dev_id": "vdevo163815529**",
                "group_id": "12856***",
                "status": true
            }
        ],
        "count": 1,
        "page_number": 1,
        "page_size": 1
    },
    "t": 1677118328341,
    "success": true
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制