设备分组树列表
接口说明
根据查询条件获取设备树结构列表
接口方法
gw.deviceGroup.treeList
请求参数
无
返回数据
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| data | array[object] | 是 | 分组信息 | |
| data.groupId | int | 是 | 分组ID | 12 |
| data.parentId | int | 是 | 父分组id | 0 |
| data.groupName | string | 是 | 分组名称 | group-1 |
| data.deviceGroupCount | object | 是 | 组下各个状态的数量 | |
| data.deviceGroupCount.deviceCount | int | 是 | 子设备数量 | 0 |
| data.deviceGroupCount.onlineCount | int | 是 | 在线设备数量 | 0 |
| data.deviceGroupCount.offlineCount | int | 是 | 离线设备数量 | 0 |
| data.deviceGroupCount.abnormalCount | int | 是 | 异常设备数量 | 0 |
| data.deviceGroupCount.inactiveCount | int | 是 | 未激活设备数量 | 0 |
| data.deviceGroupCount.alarmCount | int | 是 | 报警设备数量 | 0 |
| data.subDeviceGroupList | array[object] | 否 | 子分组 |
请求示例
{
"appId": "658409073956360262328652394",
"method": "gw.deviceGroup.treeList",
"format": "JSON",
"charset": "UTF-8",
"signType": "RSA2",
"timestamp": "1755662900000",
"version": "1.0",
"sign": "hFR2xeKVOhSIbRY8A8xrXWNY98B5kFaitoKuJXXfLsDvfeyjzfYIJkvyU2RcwYgb3L+s9aq7xfxz43K/Rx1u2QQiKt30UOS0R9Wd59gqkLVke1uV0d5n40zVX/aakt0G82IlFb4LhuTH1HuGkNfLCRWawP8uq+Q97frtrlRKmXie7zEdHtIIkbvCTOu52dASfSRIKxtr20FjAUuA/Hy/LiytUSvobM6ZycOvuvifGIOyumVTDgh1pmBc/pcP6tCTb5g2JPm6W1TY97zkIZojOH7awb579wLgdIqaACNTWQoUWLBX9xkK5HFksQhzYYIBz5NxC5PLME1LHFg82fFDw=="
}
返回示例
{
"code": "0",
"data": [
{
"groupName": "group-1",
"groupId": 305,
"parentId": 0,
"deviceGroupCount": {
"alarmCount": 0,
"onlineCount": 0,
"offlineCount": 0,
"deviceCount": 0,
"inactiveCount": 0,
"abnormalCount": 0
}
},
{
"groupName": "group-2",
"groupId": 303,
"subDeviceGroupList": [
{
"groupName": "group-3",
"groupId": 304,
"parentId": 303,
"deviceGroupCount": {
"alarmCount": 0,
"onlineCount": 0,
"offlineCount": 0,
"deviceCount": 0,
"inactiveCount": 0,
"abnormalCount": 0
}
}
],
"parentId": 0,
"deviceGroupCount": {
"alarmCount": 0,
"onlineCount": 0,
"offlineCount": 0,
"deviceCount": 0,
"inactiveCount": 0,
"abnormalCount": 0
}
}
],
"msg": "success",
"sign": "YFC+WKr/ykCpumHQVK4ekqFEi2BtOMKaUN2kzdBsjDuz24CrHtU03PVVDDph0mmFyJR4qMIr5g81/mskbMkp6Dlc/FV/GeOv5TQMjD04MId6yB5RVcbNNXp2MaQ5NkXqP0x4m9YbI6LrEMU4VTw3YPoLyE7OahzBxSaYcctjKMBUmSYc+Cy2Hsdo+ZM1qwwXqNAPWCChTtXwzHDYoQQYpfc/e081PoX28ShijZtCux8FM7M6pXXA4pOsjfiPqVeTs6V5YPKetoj0OIBHpqGKspUBA73ai7z0BRbbe6lXztZhFtsSMhgIikUfuxfREXenay/8lKonEySK0cocmngQTQ==",
"subCode": "",
"subMsg": ""
}
获取子分组列表
接口说明
根据父分组ID获取子分组列表
接口方法
gw.deviceGroup.list
请求参数
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| parentId | int | 是 | 父分组id(如果查询顶级分组,父id为0) | 0 |
| keyword | string | 否 | 关键字搜索 |
返回数据
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| data | array[object] | 是 | true | |
| data.groupId | int | 是 | 分组ID | |
| data.parentId | int | 是 | 父分组ID | |
| data.groupName | string | 是 | 分组名称 | |
| data.deviceCount | int | 是 | 组内设备数量 |
请求示例
{
"appId": "658409073956360262328652394",
"method": "gw.deviceGroup.list",
"format": "JSON",
"charset": "UTF-8",
"signType": "RSA2",
"timestamp": "1755662900000",
"version": "1.0",
"bizContent":{
"parentId":0,
"keyword":""
},
"sign": "hFR2xeKVOhSIbRY8A8xrXWNY98B5kFaitoKuJXXfLsDvfeyjzfYIJkvyU2RcwYgb3L+s9aq7xfxz43K/Rx1u2QQiKt30UOS0R9Wd59gqkLVke1uV0d5n40zVX/aakt0G82IlFb4LhuTH1HuGkNfLCRWawP8uq+Q97frtrlRKmXie7zEdHtIIkbvCTOu52dASfSRIKxtr20FjAUuA/Hy/LiytUSvobM6ZycOvuvifGIOyumVTDgh1pmBc/pcP6tCTb5g2JPm6W1TY97zkIZojOH7awb579wLgdIqaACNTWQoUWLBX9xkK5HFksQhzYYIBz5NxC5PLME1LHFg82fFDw=="
}
返回示例
{
"code": "0",
"data": [
{
"groupName": "group-1",
"deviceCount": 0,
"groupId": 303,
"parentId": 0
},
{
"groupName": "group-2",
"deviceCount": 0,
"groupId": 305,
"parentId": 0
}
],
"msg": "success",
"sign": "Mwhlp7DKAxD+sTet2WUun4/ndGqS2KjuHyST/zstMjjALVZqFaiskEUExlB8+sXOdvNwl2rDY3KZgRSswQ58wi/hz7zTKcqYCx6T2YmWjQFexne8V5M4T/5JOsMbdB7i5QYT8Wlcy41EGk3TpjDQdpo4YbA4xOi65NmSPWnKXAFy6ZUuPoljn1wB7W883XmIHM2gmmtcXbPJohNu7W1A8RZXOv5ZKc8DPM/yLOweXYcDa5xajkShIPhK78L5D0eYjR1vrC1JxwL7RlcksyiOqqyJyTuFs6TDZ/rPRbtKrN0wuwnun3tJBQy7bvak9PTgH1CGeMxZnXA+0Jl1GK7J3Q==",
"subCode": "",
"subMsg": ""
}
添加设备分组
接口说明
添加设备分组
接口方法
gw.deviceGroup.create
请求参数
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| parentId | int | 是 | 父分组id(如果是顶级分组,父分组id为0) | 0 |
| groupName | string | 是 | 分组名称 | group-1 |
返回数据
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| data | bool | 是 | true成功 false失败 | true |
请求示例
{
"appId": "658409073956360262328652394",
"method": "gw.deviceGroup.create",
"format": "JSON",
"charset": "UTF-8",
"signType": "RSA2",
"timestamp": "1755662900000",
"version": "1.0",
"bizContent":{
"parentId":306,
"groupName":"group-1"
},
"sign": "hFR2xeKVOhSIbRY8A8xrXWNY98B5kFaitoKuJXXfLsDvfeyjzfYIJkvyU2RcwYgb3L+s9aq7xfxz43K/Rx1u2QQiKt30UOS0R9Wd59gqkLVke1uV0d5n40zVX/aakt0G82IlFb4LhuTH1HuGkNfLCRWawP8uq+Q97frtrlRKmXie7zEdHtIIkbvCTOu52dASfSRIKxtr20FjAUuA/Hy/LiytUSvobM6ZycOvuvifGIOyumVTDgh1pmBc/pcP6tCTb5g2JPm6W1TY97zkIZojOH7awb579wLgdIqaACNTWQoUWLBX9xkK5HFksQhzYYIBz5NxC5PLME1LHFg82fFDw=="
}
返回示例
{
"code": "0",
"data": true,
"msg": "success",
"sign": "eAnF+imkUl+PQSOKAT4d01WSpCg+qH2a/ai/QqDbzoGiMMAAduoXGj36aTbs0iM7WEvoCrqwrPSP7G2ASOEZVCWlCna0WK3OX15wj8JMJ1cd5USoyBo44IW0mTLHs5bTjy73yEqF/g50F1ZeJvBw+aESSji5S48oGvrH1wXaSfCTZQ5+ReL9ZHvzU2lWVSfpS9DCuQ7f6g3uYBNWKAVVeRSki95Awsv4Yiqi8SBOa2ERbXmwp6LGllBEpJNarBf5VAvHUGeDSWD2nQWPsyWceZaAfViQCYf7jdMZ8JmI6bQHrYuCnhHLAjaI84DozDGc3CadZHdgOjwsO57nz9WPeQ==",
"subCode": "",
"subMsg": ""
}
修改设备分组
接口说明
修改设备分组名称
接口方法
gw.deviceGroup.update
请求参数
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| groupId | int | 是 | 用户群组ID | 203 |
| groupName | string | 是 | 群组名称 | group-1 |
返回数据
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| data | bool | 是 | true成功 false失败 | true |
请求示例
{
"appId": "658409073956360262328652394",
"method": "gw.deviceGroup.update",
"format": "JSON",
"charset": "UTF-8",
"signType": "RSA2",
"timestamp": "1755662900000",
"version": "1.0",
"bizContent":{
"groupId":305,
"groupName":"group-1"
},
"sign": "hFR2xeKVOhSIbRY8A8xrXWNY98B5kFaitoKuJXXfLsDvfeyjzfYIJkvyU2RcwYgb3L+s9aq7xfxz43K/Rx1u2QQiKt30UOS0R9Wd59gqkLVke1uV0d5n40zVX/aakt0G82IlFb4LhuTH1HuGkNfLCRWawP8uq+Q97frtrlRKmXie7zEdHtIIkbvCTOu52dASfSRIKxtr20FjAUuA/Hy/LiytUSvobM6ZycOvuvifGIOyumVTDgh1pmBc/pcP6tCTb5g2JPm6W1TY97zkIZojOH7awb579wLgdIqaACNTWQoUWLBX9xkK5HFksQhzYYIBz5NxC5PLME1LHFg82fFDw=="
}
返回示例
{
"code": "0",
"data": true,
"msg": "success",
"sign": "eAnF+imkUl+PQSOKAT4d01WSpCg+qH2a/ai/QqDbzoGiMMAAduoXGj36aTbs0iM7WEvoCrqwrPSP7G2ASOEZVCWlCna0WK3OX15wj8JMJ1cd5USoyBo44IW0mTLHs5bTjy73yEqF/g50F1ZeJvBw+aESSji5S48oGvrH1wXaSfCTZQ5+ReL9ZHvzU2lWVSfpS9DCuQ7f6g3uYBNWKAVVeRSki95Awsv4Yiqi8SBOa2ERbXmwp6LGllBEpJNarBf5VAvHUGeDSWD2nQWPsyWceZaAfViQCYf7jdMZ8JmI6bQHrYuCnhHLAjaI84DozDGc3CadZHdgOjwsO57nz9WPeQ==",
"subCode": "",
"subMsg": ""
}
删除设备分组
接口说明
删除设备分组
接口方法
gw.deviceGroup.delete
请求参数
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| groupId | int | 是 | 分组id | 203 |
返回数据
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| data | bool | 是 | true成功 false失败 | true |
请求示例
{
"appId": "658409073956360262328652394",
"method": "gw.deviceGroup.delete",
"format": "JSON",
"charset": "UTF-8",
"signType": "RSA2",
"timestamp": "1755662900000",
"version": "1.0",
"bizContent":{
"groupId":305
},
"sign": "hFR2xeKVOhSIbRY8A8xrXWNY98B5kFaitoKuJXXfLsDvfeyjzfYIJkvyU2RcwYgb3L+s9aq7xfxz43K/Rx1u2QQiKt30UOS0R9Wd59gqkLVke1uV0d5n40zVX/aakt0G82IlFb4LhuTH1HuGkNfLCRWawP8uq+Q97frtrlRKmXie7zEdHtIIkbvCTOu52dASfSRIKxtr20FjAUuA/Hy/LiytUSvobM6ZycOvuvifGIOyumVTDgh1pmBc/pcP6tCTb5g2JPm6W1TY97zkIZojOH7awb579wLgdIqaACNTWQoUWLBX9xkK5HFksQhzYYIBz5NxC5PLME1LHFg82fFDw=="
}
返回示例
{
"code": "0",
"data": true,
"msg": "success",
"sign": "eAnF+imkUl+PQSOKAT4d01WSpCg+qH2a/ai/QqDbzoGiMMAAduoXGj36aTbs0iM7WEvoCrqwrPSP7G2ASOEZVCWlCna0WK3OX15wj8JMJ1cd5USoyBo44IW0mTLHs5bTjy73yEqF/g50F1ZeJvBw+aESSji5S48oGvrH1wXaSfCTZQ5+ReL9ZHvzU2lWVSfpS9DCuQ7f6g3uYBNWKAVVeRSki95Awsv4Yiqi8SBOa2ERbXmwp6LGllBEpJNarBf5VAvHUGeDSWD2nQWPsyWceZaAfViQCYf7jdMZ8JmI6bQHrYuCnhHLAjaI84DozDGc3CadZHdgOjwsO57nz9WPeQ==",
"subCode": "",
"subMsg": ""
}