[TOC=2]
## 排除指定分组设备
~~~[api]
get:/project_group/excl_group_device
*integer:project_id=1#项目 id
*integer:group_id=0#分组 id
integer:type=0#设备类型
integer:current_page=0#当前页
integer:page_number=0#页码
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 9798,
"project_id": 19,
"device_id": 9781,
"sn": "811501001059",
"name": "99",
"type": 99,
"subtype": 0,
"province": "陕西省",
"city": "铜川市",
"district": "印台区",
"street": "",
"streetNumber": "",
"lng": "106.84679",
"lat": "34.925076",
"address": "ewwe",
"location": "",
"remarks": "",
"create_time": "2021-09-28 17:17:32",
"group_name": "测试分组1-89eew",
"group_id": 54
}
],
"current_page": 0,
"page_number": 0,
"total": 0
}
}
<<<
error
~~~
## 排除指定分组设备搜索
~~~[api]
get:/project_group/excl_group_device_search
*integer:project_id=1#项目 id
*integer:group_id=0#分组 id
*string:search=""# 支持搜索 序列号、设备名称、备注、位置
integer:type=0#设备类型
integer:current_page=0#当前页
integer:page_number=0#页码
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 9798,
"project_id": 19,
"device_id": 9781,
"sn": "811501001059",
"name": "99",
"type": 99,
"subtype": 0,
"province": "陕西省",
"city": "铜川市",
"district": "印台区",
"street": "",
"streetNumber": "",
"lng": "106.84679",
"lat": "34.925076",
"address": "ewwe",
"location": "",
"remarks": "",
"create_time": "2021-09-28 17:17:32",
"group_name": "测试分组1-89eew",
"group_id": 54
}
],
"current_page": 0,
"page_number": 0,
"total": 0
}
}
<<<
error
~~~
## 分组列表
~~~[api]
get:/project_group/list
*integer:project_id=1#项目 id
*integer:current_page=0#当前页
*integer:page_number=0#页码
integer:parent_id=0#上级分组 id
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 186,
"project_id": 86,
"name": "默认分组",
"description": "存放未分组的设备",
"parent_id": -1,
"early_warning_e": 0,
"early_warning_f": 0,
"is_store_data": 1,
"create_time": "2022-03-18 13:48:29",
"children_num": 0
}
],
"current_page": 0,
"page_number": 0,
"total": 1
}
}
<<<
explain
id // 分组 id
project_id // 项目 id
name // 分组名称
description // 分组描述
parent_id // 上级分组 id -1 为默认分组
early_warning_e // 预警电量
early_warning_f // 预警电费
create_time // 创建时间
children_num // 子分组数量
<<<
error
~~~
## 分组搜索
~~~[api]
get:/project_group/search
*integer:project_id=1#项目 id
*integer:current_page=0#当前页
*integer:page_number=0#页码
*string:search=""#分组名称、描述
integer:parent_id=0#上级分组 id
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 186,
"project_id": 86,
"name": "默认分组",
"description": "存放未分组的设备",
"parent_id": -1,
"early_warning_e": 0,
"early_warning_f": 0,
"is_store_data": 1,
"create_time": "2022-03-18 13:48:29",
"children_num": 0
}
],
"current_page": 0,
"page_number": 0,
"total": 1
}
}
<<<
explain
id // 分组 id
project_id // 项目 id
name // 分组名称
description // 分组描述
parent_id // 上级分组 id -1 为默认分组
early_warning_e // 预警电量
early_warning_f // 预警电费
create_time // 创建时间
children_num // 子分组数量
<<<
error
~~~
## 分组创建
~~~[api]
post:/project_group/save
*integer:id=0#分组 id
*integer:project_id=0#项目 id
*string:name=一级分组#分组名称
string:description=分组描述#分组描述
*integer:parent_id=0#上级分组 id 需要大于等于 0 0 表示默认分组
<<<
<<<
success
{
"code": 0
}
<<<
error
~~~
## 分组修改
~~~[api]
post:/project_group/save
*integer:id=1#分组 id
*integer:project_id=0#项目 id
*string:name=一级分组#分组名称
*string:description=分组描述#分组描述
*integer:parent_id=1#上级分组 id
<<<
<<<
success
{
"code": 0
}
<<<
error
~~~
>[danger] 分组创建和修改就一个分组 id 的值差异，id 值为 0 则创建分组，其他则修改分组
> 默认分组信息不能修改
## 分组删除
~~~[api]
post:/project_group/delete
*array:id_list=[]#分组 id 数组
*integer:project_id=0#项目 id
<<<
<<<
success
{
"code": 0
}
<<<
error
~~~
>[danger] 默认分组不会被删除
## 分组下的设备
~~~[api]
get:/project_group/device
*integer:project_id=0#项目 id
*integer:group_id=0#分组 id
integer:type=0#设备类型
integer:current_page=0#当前页
integer:page_number=0#页码
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 9,
"project_id": 2,
"device_id": 6,
"sn": "746814001309",
"name": "2145",
"type": 76,
"subtype": 0,
"province": "甘肃省",
"city": "武威市",
"district": "民勤县",
"street": "",
"streetNumber": "",
"lng": "102.946563",
"lat": "38.421518",
"address": "00",
"location": "00",
"remarks": "00",
"create_time": "2021-05-07 14:15:04",
"group_name": "一级分组",
"group_id": 11
}
],
"current_page": 0,
"page_number": 0,
"total": 1
}
}
<<<
explain
id // 项目设备 id
project_id // 项目 id
device_id // 设备 id
sn // 设备序列号
name // 设备名称
type // 设备类型
subtype // 设备子类型
province // 省
city // 市
district // 区
street // 街道
streetNumber // 门牌号
lng // 经度
lat // 纬度
address // 详细地址
location // 安装位置
remarks // 备注信息
create_time // 添加时间
group_name // 分组名称
group_id // 分组 id
<<<
error
~~~
## 分组下的设备移除
~~~[api]
post:/project_group/group_device_remove
*int:project_id=0#项目 id
*array:id_list=[0]#要移除的项目设备 id
<<<
<<<
success
{
"code": 0
}
<<<
error
~~~
## 分组下的设备搜索
~~~[api]
get:/project_group/device_search
*integer:project_id=0#项目 id
*integer:group_id=0#分组 id
*integer:type=0#设备类型
*integer:current_page=0#当前页
*integer:page_number=0#页码
*string:search=""#可以搜索设备序列号、设备名称、设备备注、安装位置
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 9,
"project_id": 2,
"device_id": 6,
"sn": "746814001309",
"name": "2145",
"type": 76,
"subtype": 0,
"province": "甘肃省",
"city": "武威市",
"district": "民勤县",
"street": "",
"streetNumber": "",
"lng": "102.946563",
"lat": "38.421518",
"address": "00",
"location": "00",
"remarks": "00",
"create_time": "2021-05-07 14:15:04",
"group_name": "一级分组",
"group_id": 11
}
],
"current_page": 0,
"page_number": 0,
"total": 1
}
}
<<<
explain
id // 项目设备 id
project_id // 项目 id
device_id // 设备 id
sn // 设备序列号
name // 设备名称
type // 设备类型
subtype // 设备子类型
province // 省
city // 市
district // 区
street // 街道
streetNumber // 门牌号
lng // 经度
lat // 纬度
address // 详细地址
location // 安装位置
remarks // 备注信息
create_time // 添加时间
group_name // 分组名称
group_id // 分组 id
<<<
error
~~~
## 更改设备分组
~~~[api]
post:/project_group/change_group
*integer:project_id=1#项目 id
*integer:group_id=0#目标分组 id
*array:id_list=[]#项目设备 id 数组
<<<
<<<
success
{
"code": 0
}
<<<
error
~~~
## 分组包含的设备类型
~~~[api]
get:/project_group/get_device_type
*integer:project_id=1#项目 id
*integer:group_id=0#分组 id
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"type": 46
},
{
"type": 29
},
]
}
}
<<<
error
~~~
## 分组设备统计
~~~[api]
post:/project_group/quantity_statistics
*integer:project_id=1#项目 id
*array:group_ids=[]#分组 id 数组
<<<
<<<
success
{
"code": 0,
"data": {
"2": {
"total": 5,
"online": 5,
"offline": 0
},
}
}
<<<
explain
键值为 分组的 id
total // 设备总数
online // 在线设备数
offline // 离线设备数
<<<
error
~~~
## 分组汇总
~~~[api]
post:/project_group/group_gather
*integer:project_id=1#项目 id
*array:group_ids=[]#分组 id 数组
<<<
<<<
success
{
"code": 0,
"data": {
"186": {
"device_total": 3,
"scene_total": 3
}
}
}
<<<
explain
键值为 分组的 id
device_total // 设备总数
scene_total // 情景总数
<<<
error
~~~
