[TOC=2]
## 检查设备是否添加
~~~[api]
post:/installers/project_device/check_device_add
*integer:project_id=1#项目 id
*array:sn_list=[]#设备序列号数组
<<<
<<<
success
{
"code": 0,
"data": {
"list": {
"915001000053": {
"is_add": false
},
"915001000099": {
"is_add": false
},
"915001000003": {
"is_add": true
}
}
}
}
<<<
explain
915001000053 // sn_list 内填写的设备序列号
is_add // 是否添加过
true => 已添加
false => 未添加
<<<
error
~~~
## 设备列表
~~~[api]
get:/installers/project_device/list
*integer:project_id=1#项目 id
*integer:current_page=0#当前页
*integer:page_number=0#页码
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 1,
"project_id": 2,
"device_id": 1,
"sn": "746051001790",
"name": "智能空调",
"type": 46,
"subtype": 0,
"province": "陕西省",
"city": "安康市",
"district": "汉阴县",
"street": "",
"streetNumber": "",
"lng": "108.392163",
"lat": "32.714036",
"address": "123",
"location": "123",
"remarks": "123",
"create_time": "2021-05-07 10:28:59",
"group_name": "默认分组",
"group_id": 2
}
],
"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]
get:/installers/project_device/type_list
*integer:project_id=1#项目 id
*integer:current_page=0#当前页
*integer:page_number=0#页码
*integer:type=0#设备类型
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 1,
"project_id": 2,
"device_id": 1,
"sn": "746051001790",
"name": "智能空调",
"type": 46,
"subtype": 0,
"province": "陕西省",
"city": "安康市",
"district": "汉阴县",
"street": "",
"streetNumber": "",
"lng": "108.392163",
"lat": "32.714036",
"address": "123",
"location": "123",
"remarks": "123",
"create_time": "2021-05-07 10:28:59",
"group_name": "默认分组",
"group_id": 2
}
],
"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]
get:/installers/project_device/search
*integer:project_id=1#项目 id
*integer:current_page=0#当前页
*integer:page_number=0#页码
*integer:type=0#设备类型
*string:search=''''#可搜序列号、设备名称、备注信息、安装位置
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 1,
"project_id": 2,
"device_id": 1,
"sn": "746051001790",
"name": "智能空调",
"type": 46,
"subtype": 0,
"province": "陕西省",
"city": "安康市",
"district": "汉阴县",
"street": "",
"streetNumber": "",
"lng": "108.392163",
"lat": "32.714036",
"address": "123",
"location": "123",
"remarks": "123",
"create_time": "2021-05-07 10:28:59",
"group_name": "默认分组",
"group_id": 2
}
],
"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]
get:/installers/project_device/get_device_type
*integer:project_id=1#项目 id
integer:is_device_num=0#是否返回对应设备数量
<<<
<<<
field_explain
is_device_num // 是否返回对应设备数量
0 => 不返回
1 => 返回
<<<
success
{
"code": 0,
"data": {
"list": [
{
"type": 29,
"name": "电暖温控器",
"mark":""
},
{
"type": 27,
"name": "空调伴侣",
"mark":""
},
]
}
}
<<<
success
{
"code": 0,
"data": {
"list": [
{
"type": 29,
"name": "电暖温控器",
"mark":"",
"total": 1
},
{
"type": 27,
"name": "空调伴侣",
"mark":"",
"total": 3
},
]
}
}
<<<
success_explain
type // 设备类型
name // 设备类型名称
mark // 设备类型对应型号
total // 对应设备数量
<<<
error
~~~
## 项目设备统计
~~~[api]
post:/installers/project_device/device_total
*array:project_ids=[1]#项目 id 数组
<<<
<<<
success
{
"code": 0,
"data": {
"list": {
"4": {
"total": 1
},
"2": {
"total": 6
}
}
}
}
<<<
error
~~~
## 设备信息修改
~~~[api]
post:/installers/project_device/update
*integer:id=0#项目设备 id
*integer:project_id=0#项目 id
string:name=''''#设备名称
string:location=''''#安装位置
string:remarks=''''#备注信息
<<<
<<<
success
{
"code": 0
}
<<<
error
~~~
>[info] 可以只传 name、location、remarks 的字段中其中任意一个字段。不修改可以不传值
## 设备密码修改
~~~[api]
post:/installers/project_device/update_pwd
*integer:id=0#项目设备 id
*integer:project_id=0#项目 id
*string:password=666666#设备原密码
*string:password_new=777777#设备新密码
<<<
<<<
success
{
"code": 0
}
<<<
error
{
"code": 502,
"msg": "设备密码错误"
}
~~~
## 设备位置修改
~~~[api]
post:/installers/device_info/update
*integer:id=0#项目设备 id
*string:province=""#省
*string:city=""#市
*string:district=""#区
*string:street=""#街道
*string:streetNumber=""#门牌号
*string:lng=""#地理经度
*string:lat=""#地理纬度
*string:address=""#详细地址
<<<
<<<
success
{
"code": 0
}
<<<
error
~~~
## 设备添加
~~~[api]
post:/installers/project_device/save
*integer:project_id=0#项目 id
*integer:group_id=0#项目分组 id
*string:sn=""#设备序列号
string:name=""#设备名称
*string:password=""#设备密码
integer:bind_type=0 #添加设备类型 1 新设备 ， 0 已经联网设备
string:location=""#设备安装位置
string:remarks=""#设备备注信息
string:province=""#省
string:city=""#市
string:district=""#区
string:street=""#街道
string:streetNumber=""#门牌号
string:lng=""#地理经度
string:lat=""#地理纬度
string:address=""#详细地址
<<<
<<<
success
{
"code": 0,
"data": {
"device_info": {
"id": 10,
"device_id": 9,
"type": 29,
"subtype": 0
}
}
}
<<<
error
{
"code": -1,
"msg": "设备密码不能为空"
}
~~~
>[danger] 必填字段有 project_id、group_id、sn、password、name
> group_id 值可以为 0 表示添加到默认分组
> bind_type 默认为 0 表示添加已经联网的设备， 1 表示添加新配网的设备
## 设备删除
~~~[api]
post:/installers/project_device/delete
*integer:project_id=默认值#说明文字
*array:id_list=[]#设备列表内返回的 id 字段值
<<<
<<<
success
<<<
error
~~~
