API接口文档
一、协议说明
1、协议类型说明
读取接口使用GET
控制接口使用POST，参数data:JSON
二、基础控制
1、用户登录
http://119.45.163.5:1125/zjl/API/login?
{"username":"admin","password":"12345678"}

2、获取全部设备状态
http://119.45.163.5:1125/zjl/API/getDevList?
字段 字段说明 备注
kt_token 登录回参
kt_dwid 公司ID 登录回参
回参：
字段 字段说明 备注
dev_id 设备ID
online 88和66在线，其他离线 设备状态
xh 信号强度
kt_lock 0未锁，1锁定 锁定状态
pwr 0关闭，1开启 开关
mode 1制热，2制冷，3送风，4除湿 模式
fan 1低速2中速3高速4自动 风速状态
fan_set 1低速2中速3高速4自动 设定风速
sf_pwr 0关闭，1开启 水阀状态
temp 显示的要除以10 环境温度
temp_set 显示的要除以10 设定温度
stop_logo 0停机，1未停 停机状态
sum_runtime 总运行时长
hig_runtime 高速运行时长
mid_runtime 中速运行时长
low_runtime 低速运行时长
wg_id 网关id
wg_mac 网关mac地址
wg_qid 设备地址
dev_name 设备名称
floor_id 楼层id
floor_name 楼层名称
room_id 房间id
room_name 房间名称
dev_type_id 设备类型id
dev_type_name 设备类型名称
uptime 上报时间
2.1获取单台设备状态
http://119.45.163.5:1125/zjl/API/getDevOne?kt_token=172588271126741&kt_dwid=0&kt_sonid=0&wg_
mac=010000000001&wg_qid=1
wg_mac平台添加的对应网关mac地址
wg_qid网关下的设备地址（设备管理中的设备ID）
3、单个设备控制
http://119.45.163.5:1125/zjl/API/devCtr?
请求方式POST
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"wg_mac":"9abde73056c353e3",
"wg_qid":"1",
"pid":"sj",
"set_type":"pwr",
"set_val":0,
"ctr_type":"set_one",
"kt_sonid":"0"
}
http://119.45.163.5:1125/zjl/API/devCtr?
字段 字段说明 备注
kt_token 登录回参
kt_dwid 公司ID 登录回参
pid 水机sj、多联机dlj（获取状态时返回） 设备类型
wg_mac 网关mac地址
wg_qid 设备地址
ctr_type set_one单条控制 控制类型
set_typepwr开关，mode模式
fan风速，temp温度设置类型
set_val 0关闭，1开启 开关设置值
set_val 1制热，2制冷，3送风，4除湿 模式设置值
set_val 1低风，2中风，3高风，4自动 风速设置值
set_val 温度值*10 温度设置值
回参：
字段 字段说明 备注
code 200成功，500报错
4、多个设备同时控制
http://119.45.163.5:1125/zjl/API/devManyCtr?
{
"ctr_type":"set_many",
"li_data":[
{
"wg_mac":"9abde73056c353e3",
"wg_qid":"91f64e6991f64e69",
"pid":"sj",
"set_type":"pwr",
"set_val":1
},
{
"wg_mac":"9abde73056c353e3",
"wg_qid":"931a964e931a964e",
"pid":"sj",
"set_type":"pwr",
"set_val":1
}
],
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0"
}
5、多功能组合控制
http://119.45.163.5:1125/zjl/API/devCtr?
字段 字段说明 备注
ctr_type set_one单设备，set_many多设备 控制类型
pid 水机sj、多联机dlj（获取状态时返回） 设备类型
set_type many_ctr 设置类型
set_val {"pwr":1,"mode":1} 值和单功能一致
6、锁定控制
http://119.45.163.5:1125/zjl/API/devManyCtr?
字段 字段说明 备注
pid 水机sj、多联机dlj（获取状态时返回） 设备类型
set_type many_ctr 设置类型
set_val 设置值
lock_pwr 0解锁，1锁定 锁定设置
pwr 0锁定关机，1锁定开机，-1不锁定 开关锁定
mode 1锁定制热，2制冷，3送风，4除湿，-1不锁 模式锁定
fan 1锁定低风，2中风，3高风，4自动，-1不锁 风速锁定
min_temp 温度值*10，-1不锁 温度下限
max_temp 温度值*10，-1不锁 温度上限
三、设备管理
1、网关管理
1）获取网关
回参：
{
"code":200,
"message":"ok",
"data":[{
"wg_id":1,
"wg_mac":"000000000416",
"wg_bz":"",
"wg_status":"在线"，
"area":{}，//区域
}]
}
2）添加网关
3）修改网关
4）删除网关

5）网关关联区域
http://119.45.163.5:1125/zjl/API/wgWithArea?
请求方式：POST
{
"id":1852,
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":1,
"room_id":6786
}
2、设备管理
1）获取设备
回参：
{
"code":200,
"message":"ok",
"data":[{
"wg_mac":"000000000416",
"floor_name":"1",
"room_name":"22",
"dev_type_name":"水机",
"dev_id":1,
"floor_id":1,
"room_id":1,
"wg_id":1,
"wg_qid":3,
"dev_name":"22-03",
"dev_bz":"",
"dev_type_id":1
}]
}
字段 字段说明 备注
wg_id 网关id
wg_mac 网关mac地址
wg_qid 设备地址
dev_id 设备id
dev_name 设备名称
floor_id 楼层id
floor_name 楼层名称
room_id 房间id
room_name 房间名称
dev_type_id 设备类型id
dev_type_name设备类型名称
dev_bz 设备备注
2）添加设备
http://119.45.163.5:1125/zjl/API/addDev?
字段 字段说明 备注
wg_id 网关id
wg_qid 设备地址
floor_id 楼层id
room_id 房间id
dev_name 设备名称
dev_type_id 设备类型id
dev_bz 备注
3）修改设备
4）删除设备

四、区域管理
1、房间管理
1）获取房间
回参：
{
"code":200,
"data":[{
"room_id":49,
"floor_id":1,
"room_name":"111",
"room_bz":""
}],
"message":""
}
字段 字段说明 备注
floor_id 楼层id
room_id 房间id
room_name 房间名称
room_bz 房间备注
2）添加房间
3）修改房间

4）删除房间
2、楼层管理
1）获取楼层
http://119.45.163.5:1125/zjl/API/getFloor?kt_token=172588271126741
&kt_dwid=0&kt_unit=1&kt_sonid=0&page=1&pageSize=100
字段 字段说明 备注
kt_token
kt_dwid 公司id
kt_unit 单元id
kt_sonid 账号id
page 页
pageSize 一页条数
回参：
{
"code":200,
"message":"ok",
"data":[{
"floor_id":1,
"floor_name":"1",
"floor_bz":""
}]
}
字段 字段说明 备注
floor_id 楼层id
floor_name 楼层名称
floor_bz 楼层备注
2）添加楼层
http://119.45.163.5:1125/zjl/API/addFloor?
字段 字段说明 备注
kt_token
kt_dwid 公司id
kt_unit 单元id
kt_sonid 账号id
floor_name 楼层名称
floor_bz 楼层备注
3）修改楼层
http://119.45.163.5:1125/zjl/API/changeFloor?
字段 字段说明 备注
kt_token
kt_dwid 公司id
kt_unit 单元id
kt_sonid 账号id
floor_id 楼层id
floor_name 楼层名称
floor_bz 楼层备注
4）删除楼层
3、单元管理
1）获取单元
http://119.45.163.5:1125/zjl/API/getUnit?kt_token=v14YwV2SKsq477W9sw4z5m3O667g1&kt_d
wid=20&kt_sonid=0&page=1&pageSize=100000
请求方式GET
2）添加单元
http://119.45.163.5:1125/zjl/API/addUnit?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"building_id":21,
"unit_name":"1",
"unit_bz":""
}
3）修改单元
http://119.45.163.5:1125/zjl/API/changeUnit?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"unit_id":527,
"unit_name":"12",
"unit_bz":""
}
4）删除单元
http://119.45.163.5:1125/zjl/API/delUnit?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"unit_id":527
}
4、楼栋管理
1）获取楼栋
http://119.45.163.5:1125/zjl/API/getBuilding?kt_token=v14YwV2SKsq477W9sw4z5m3O667g1&k
t_dwid=20&kt_sonid=0&page=1&pageSize=100000
请求方式GET
2）添加楼栋
http://119.45.163.5:1125/zjl/API/addBuilding?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"area_id":21,
"building_name":"1F",
"building_bz":""
}
3）修改楼栋
http://119.45.163.5:1125/zjl/API/changeBuilding?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"building_id":335,
"building_name":"2F",
"building_bz":""
}
4）删除楼栋
http://119.45.163.5:1125/zjl/API/delBuilding?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"building_id":294
}
5、小区管理
1）获取小区
http://119.45.163.5:1125/zjl/API/getArea?kt_token=v14YwV2SKsq477W9sw4z5m3O667g1&kt_d
wid=20&kt_sonid=0&page=1&pageSize=100000
请求方式GET
2）添加小区
http://119.45.163.5:1125/zjl/API/addArea?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"area_name":"1area",
"area_bz":""
}
3）修改小区
http://119.45.163.5:1125/zjl/API/changeArea?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"area_id":298,
"area_name":"2area",
"area_bz":""
}
4）删除小区
http://119.45.163.5:1125/zjl/API/delArea?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"area_id":298
}
五、定时管理
1、获取定时
回参：
{
"code":200,
"message":"ok",
"data":[{
"id":9,
"time_pwr":1,
"time_week":"0,1,2,3,4,5,6,",
"time_type":"lock",
"uptime":"15:05:00",
"li_devid":[1099],
"d_scene":{
"li_data":[{
"set_type":"lock_many",
"set_val":{
"lock_pwr":1,
"pwr":0,
"mode":2,
"fan":3,
"min_temp":160,
"max_temp":320
},
"wg_mac":"010000000001",
"wg_qid":1
}]
},
"time_bz":"定时1"
}]
}
字段 字段说明 备注
id 定时id
time_pwr 定时开关
time_week 0周一，6周日
time_type pwr开关，lock锁定，many组合控制 定时类型
uptime 定时时间
li_devid 设备id集合
li_data 场景集合
set_type many_ctr控制，lock_many锁定 设置类型
set_val 和设备控制一致 设置值
wg_mac 网关mac
wg_qid 网关qid
2、添加定时
http://119.45.163.5:1125/zjl/API/addTiming?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"uptime":"18:00",
"li_devid":[
43868
],
"time_pwr":1,
"time_type":"pwr",
"d_scene":{
"li_data":[
{
"set_type":"pwr",
"set_val":0,
"wg_mac":"000000001403",
"wg_qid":"3",
"pid":"sj"
}
]
},
"date_type":0,
"time_date":"",
"time_week":"0,1,2,3,4,",
"time_bz":"定时1",
"sceneId":0,
"sceneName":""
}
time_pwr定时开关 0关闭、1开启
time_type定时类型 开关pwr、场景scene、锁定控制lock
组合控制many
d_scene{li_data:[]}控制内容 和批量控制一致
date_type时间类型 0周期控制、1日期控制
time_week周期 0周一、6周日
time_date定时日期2026-01-07
sceneId场景ID 和场景关联执行
sceneName场景名称 和场景关联执行
3、修改定时
4、删除定时
6、关联区域
http://119.45.163.5:1125/zjl/API/timingWithArea?
{
"id":593,
"kt_dwid":"20",
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"room_id":6783
}
六、数据查询
1、网关上线/离线记录
2、设备控制记录
http://119.45.163.5:1125/zjl/API/getLogDev?kt_token=172594860456857&kt_dwid=20&kt_
sonid=0&start_time=2025-07-21&end_time=2025-07-22&page=1&pageSize=10

七、计量管理
1、计量系数
1）获取计量系数
http://119.45.163.5:1125/zjl/API/getDlSjXs?kt_token=172588271126741&kt_dwid=0&kt_sonid=0&kt_uni
t=1
回参：
字段 字段说明 备注
dev_id 设备ID
kt_dj 计费电价
kw_type 0时长计费1能耗计费2电表计费 计费类型
hig_kw 高档风速系数
mid_kw 中档风速系数
low_kw 低档风速系数
fan_arg 盘管系数
fan_kw 风机耗电
cold_kw 制冷占比 暂未用
heat_kw 制热占比 暂未用
day_kw 外机日耗电 暂未用
2）修改计量系数
http://119.45.163.5:1125/zjl/API/changeDlSjXs?
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"dev_id":43868,
"kt_sonid":"0",
"kw_type":1,
"fan_arg":1,
"fan_kw":1,
"hig_kw":1.3,
"mid_kw":1.1,
"low_kw":1
}
2、电表管理
1）获取电表列表
http://119.45.163.5:1125/zjl/API/glDb/getDb?kt_token=172588271126741&kt_dwid=0&kt_sonid=0&kt_
unit=1&page=1&pageSize=100000
筛选单台电表加&db_mac=990000011e01
回参：
字段 字段说明 备注
db_id 电表id
wg_mac 电表网关MAC
wg_id 电表网关id
xy_name 协议名称
xy_id 协议id
db_adr 电表地址
db_name 电表名称
db_bb 变比
db_rhd 外机日耗电
li_dev [1099,1100,1102] 设备id列表
db_bz 备注
db_data 最新一条数据
db_uptime 最新一条数据时间
2）添加电表
http://119.45.163.5:1125/zjl/API/glDb/addDb?
{
"kt_token":"172588271126741",
"kt_dwid":"0",
"kt_sonid":"0",
"kt_unit":"1",
"wg_id":147,
"xy_id":2,
"db_adr":"1",
"db_name":"1",
"db_bb":1,
"db_rhd":0,
"db_bz":"1",
"li_dev":[1,3]
}
3）修改电表信息
http://119.45.163.5:1125/zjl/API/glDb/changeDb?
{
"kt_token":"172588271126741",
"kt_dwid":"0",
"kt_sonid":"0",
"kt_unit":"1",
"db_id":1,
"wg_id":147,
"xy_id":2,
"db_adr":"1",
"db_name":"电表1",
"db_bb":30,
"db_rhd":0,
"db_bz":"",
"li_dev":[
1099,
1100,
1102
]
}
4）删除电表
http://119.45.163.5:1125/zjl/API/glDb/delDb?
5）触发电表查询电量
http://119.45.163.5:1125/zjl/API/devCtr?
请求类型POST
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"wg_mac":"990000011e01",
"wg_qid":"1",
"ctr_type":"set_one",
"set_type":"find_dn",
"set_val":{
"db_bb":1,
"xy_name":"645协议"
}
}
6）触发电表查询功率
http://119.45.163.5:1125/zjl/API/devCtr?
请求类型POST
{
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"kt_dwid":"20",
"kt_sonid":"0",
"wg_mac":"990000011e01",
"wg_qid":"1",
"ctr_type":"set_one",
"set_type":"find_power",
"set_val":{
"db_bb":1,
"xy_name":"645协议"
}
}
7）查询电表数据
http://119.45.163.5:1125/zjl/API/getDbDaySum?kt_token=172588271126741&kt_dwid=0&kt_unit=1&kt_
sonid=0&start_time=2024-12-03&end_time=2024-12-04
回参：
字段 字段说明 备注
uptime 上报时间
wg_mac 电表网关mac
db_adr 电表地址
dl 电量
3、电量数据
1）日电量报表
http://119.45.163.5:1125/zjl/API/getDayDl?kt_token=v14YwV2SKsq477W9sw4z5m3O667g1&kt_dwid=20
&kt_sonid=0&page=1&pageSize=1000000&start_time=2026-01-06&end_time=2026-01-07
筛选公司加&gs_id=1
筛选设备加&dev_id=10
回参：
字段 字段说明 备注
dev_id 设备ID
uptime 计费时间
sum_df 当日总电费
sum_dl 当日总电量
sum_time 当日总运行时间
hig_time 当日高档运行时间
mid_time 当日中档运行时间
low_time 当日低档运行时间
2）月电量报表
http://119.45.163.5:1125/zjl/API/getMoonDl?kt_token=v14YwV2SKsq477W9sw4z5m3O667g1&k
t_dwid=20&kt_sonid=0&page=1&pageSize=1000000&date=2025-12
筛选公司加&gs_id=1
4、计费公司管理
1）获取公司列表
http://119.45.163.5:1125/zjl/API/getGs?kt_token=v14YwV2SKsq477W9sw4z5m3O667g1&kt_dwi
d=20&kt_sonid=0
筛选公司加&id=1
回参：
字段 字段说明 备注
id 公司id
uptime 上报时间
is_pwr 充值开关
is_rest_stop 夜间不停机
gs_name 公司名称
left_money 剩余金额
left_money_y 昨日剩余金额
is_stop 是否停机
li_dev 设备列表
d_dev 分摊比例 暂未启用
gs_bz 公司备注
2）添加公司
http://119.45.163.5:1125/zjl/API/addGs?
{
"kt_token":"172588271126741",
"kt_dwid":"0",
"kt_unit":"1",
"kt_sonid":"0",
"is_pwr":1,
"li_dev":[
1,
2
],
"d_dev":{
"1":100,
"2":100
},
"gs_name":"公司1",
"is_rest_stop":1,
"gs_bz":""
}
3）修改公司信息
http://119.45.163.5:1125/zjl/API/changeGs?
{
"id":52,
"is_pwr":1,
"is_rest_stop":1,
"gs_name":"公司1",
"left_money":0,
"is_stop":0,
"li_dev":[
1,
2
],
"d_dev":{
"1":100,
"2":100
},
"gs_bz":"",
"is_pwr_xs":"开启",
"is_stop_xs":"未停机"
}
4）删除公司
http://119.45.163.5:1125/zjl/API/delGs?
{
"kt_token":"172588271126741",
"kt_dwid":"0",
"kt_sonid":"0",
"kt_unit":"1",
"id":52
}
5）关联区域
http://119.45.163.5:1125/zjl/API/gsWithArea?
{
"id":2431,
"kt_dwid":"20",
"kt_token":"v14YwV2SKsq477W9sw4z5m3O667g1",
"room_id":6783
}
6）充值费用
http://119.45.163.5:1125/zjl/API/addMoney?
{
"kt_token":"172588271126741",
"kt_dwid":"0",
"kt_unit":"1",
"kt_sonid":"0",
"id":54,
"cz_money":"100"
}
7）清空金额
http://119.45.163.5:1125/zjl/API/cleanMoney?
{
"kt_token":"172588271126741",
"kt_dwid":"0",
"kt_unit":"1",
"kt_sonid":"0",
"id":54
}
8）查询充值记录
http://119.45.163.5:1125/zjl/API/getCzLog?kt_token=172588271126741&kt_dwid=0&kt_unit=1&kt_soni
d=0&start_time=2024-12-03&end_time=2024-12-05&page=1&pageSize=100000
回参：
字段 字段说明 备注
gs_name 公司名称
uptime 充值时间
cz_user 充值用户
cz_tip 充值提示
cz_money 充值金额
left_money 剩余金额
八、账号管理
1、获取账号
回参：
{
"code":200,
"message":"ok",
"data":[{
"user_id":1,
"kt_token":"172588271126741",
"kt_dwid":0,
"username":"admin",
"kt_qx":0,
"kt_level":0,
"kt_sonid":0,
"kt_area":"0",
"cz_pwr":0,
"gs_name":"智精灵",
"kt_bz":"",
"end_time":"2228-08-0808:08:08",
"kt_unit":"1"
}]
}
字段 字段说明 备注
user_id 用户id
username 用户名称
kt_qx 用户权限
kt_level 0：所有功能可控 控制权限
kt_area 0：超级管理员 权限等级
kt_unit "0"：所有区域，和kt_level关联 可控制区域
2、添加子账号
http://119.45.163.5:1125/zjl/API/addUser?
字段 字段说明 备注
kt_qx0所有功能可控
1只能控制，不能修改设备信息
2只能查看，不能控制修改
kt_level0超级管理员
1设备管理员
2房间管理员
3楼层管理员
4单元管理员
5楼栋管理员
6区域管理员
kt_area根据kt_level改变
如kt_level为1，填入选择的设备id
字符串"0,1,2,3,35,38,49,"
为2则填入房间的id
3、修改账号信息
4、修改账号密码

5）删除账号