[关闭]
@xuduochoua 2018-04-10T07:36:39.000000Z 字数 19523 阅读 1616

云电桩运维接口并SQL

接口 winsky

一、接口文档

接口通用说明

  1. {
  2. code:0,//返回码 0-默认 成功
  3. msg:"",//错误码说明信息
  4. data:null//接口需求的具体数据 或List 或String 等
  5. }
  1. http://192.168.0.36:10081/pamapi
  1. 对所有请求参数进行AES统一加密,加密keysAl(@E20-*2+!#$bc95
  2. 对所用返回数据进行AES统一加密,加密keysAl(@E20-*2+!#$bc95
  3. 后期可考虑token + 签名方式 + restful风格
  1. 401 : 未登录
  2. 400 请求参数错误

一、系统模块

1.1.登陆

接口地址:
POST /system/login.pam

根据角色判断属于全国还是城市 根据子公司城市判断所属城市

请求参数:

参数 数据类型 必填 参数说明
username string Y 账户
password string Y 密码

错误码说明

code 错误原因 返回消息
609 密码错误 密码错误
608 不存的用户 不存在的用户
607 用户被禁用 用户被禁用

响应结果:

  1. {
  2. "code": 0, //0 - 接口调用成功,其他值表示失败
  3. "message": "",
  4. "data": {
  5. "id":"xxx",
  6. "username;":"xxx",
  7. "roleType":1,//1-客服,2-总部运维专员,3-总部运维主管,4-维修主管,5-运维专员,6-运维主管,
  8. "roleName":"客服",
  9. "cityId":null,//当为总部角色的时候 返回空
  10. "cityName":"全国"
  11. "subcompany":654asd61", //所属公司id 总公司为空
  12. "subcompanyName::"合肥子公司" //所属公司名称 总公司为空
  13. }
  14. }

1.2 忘记密码

接口地址:
POST /system/forget.pam
请求参数:

参数 数据类型 必填 参数说明
mobile String Y 手机号
username String Y 用户名

运行时异常

code 错误原因 返回消息
608 不存在的用户 不存在的用户或者用户名和手机号不匹配
607 用户被禁用 用户被禁用

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

1.3 修改密码

接口地址:
POST /syetem/updatePassword.pam
请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id
oldPassword String Y 旧密码
newPassword String Y 新密码

运行时异常

code 错误原因 返回消息
609 密码错误 密码错误
608 不存的用户 不存在的用户
607 用户被禁用 用户被禁用

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

1.4 退出登陆

接口地址:
POST /system/logout.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

1.5 城市列表(省-市)

省列表,省当中包含市列表

接口地址:
POST /system/cities.pam

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "id":"101101",
  6. "name":"安徽省"
  7. "cities":[{
  8. "id":"10101001",
  9. "name":"合肥市"
  10. },....
  11. ]
  12. },....
  13. ]
  14. }

1.6 故障类型

接口地址:
POST /system/alarmCategories.pam

请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. "id":1,
  7. "name":"网络异常"
  8. },{
  9. ...
  10. }
  11. ]
  12. }

1.7 电桩系列

接口地址:
POST /system/stakeModels.pam 或者/group/groupStakeSeries.pam
请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. "id":1,
  7. "name":"盛宏交流"
  8. },{
  9. ...
  10. }
  11. ]
  12. }

1.8 选择公司

接口地址:
GET /system/cityCompanys.pam
请求参数:

参数 数据类型 必填 参数说明
companyId String Y 当前用户管辖的公司id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. "id":1,
  7. "name":"公司1"
  8. },{
  9. ...
  10. }
  11. ]
  12. }

二、电桩和电枪相关数据统计与展示

2.1.全国电桩统计

接口地址:
POST /group/allGroupSurvey.pam

请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "free":1,//空闲数
  6. "use":1,//使用数
  7. "offline":1,//离线数
  8. "alarm":1//告警数
  9. }
  10. }

2.2.城市电桩统计

接口地址:
POST /group/cityGroupSurvey.pam
请求参数:

参数 数据类型 必填 参数说明
cityId String Y 城市id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data: {
  5. "free":1,//空闲数
  6. "use":1,//使用数
  7. "offline":1,//离线数
  8. "alarm":1//告警数
  9. }
  10. }

2.3.全国电枪统计

接口地址:
POST /group/allGunSurvey.pam
请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "free":1,//空闲数
  6. "appointment":1,//预约数
  7. "charge":1,//充电数
  8. "unuse":1,//未使用数
  9. "unback":1//未放回数
  10. }
  11. }

2.4.城市电枪统计

接口地址:
POST /group/cityGunSurvey.pam
请求参数:

参数 数据类型 必填 参数说明
cityId String Y 城市id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "free":1,//空闲数
  6. "appointment":1,//预约数
  7. "charge":1,//充电数
  8. "unuse":1,//未使用数
  9. "unback":1//未放回数
  10. }
  11. }

2.5 全国电桩分布

接口地址:
POST /group/allStakeDistribution.pam

请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "provinceId":"101001340",//省code
  6. "provinceName":"安徽省",//省命名
  7. "distributions":
  8. [{
  9. "cityId":"101001340010",
  10. "cityName":"合肥市",
  11. "num":11
  12. },{
  13. "cityId":"101001340020",
  14. "cityName":"芜湖市",
  15. "num":11
  16. },...]
  17. },..
  18. ]
  19. }

2.6 全国枪分布

接口地址:
POST /group/allGunDistribution.pam

请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "provinceId":"101001340",//省code
  6. "provinceName":"安徽省",//省命名
  7. "distributions":
  8. [{
  9. "cityId":"101001340010",
  10. "cityName":"合肥市",
  11. "num":11
  12. },{
  13. "cityId":"101001340020",
  14. "cityName":"芜湖市",
  15. "num":11
  16. },...]
  17. },..
  18. ]
  19. }

2.7城市不同状态枪列表

接口地址:
POST /group/cityGuns.pam

请求参数:

参数 数据类型 必填 参数说明
cityId String Y 城市id
gunType int N 枪列表类型 1-默认,空闲,2-预约,3-充电,4-不可用,5-未放回
page int N 当前页码 默认1
size int N 当前页数据量 默认10

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "total":10,
  6. "pageNum":1,
  7. "pageSize":8,
  8. "pages":6,
  9. "size":8,
  10. list: [{
  11. "id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id
  12. "name":"康桥诺富特充电站",//桩群名称
  13. "address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址
  14. "totalGunNum":2,//总枪数
  15. "totalDcGunNum":1,//总直流枪数
  16. "totalAcGunNum":1,//总交流枪数
  17. "statusGunNum":2,//当前状态总枪数
  18. "statusDcGunNum":1,//当前状态直流枪数
  19. "statusAcGunNum":1//当前状态交流枪数
  20. },...
  21. ]
  22. }
  23. }

2.8 桩群电枪详情

接口地址:
POST /group/groupGunDetail.pam

请求参数:

参数 数据类型 必填 参数说明
groupId String Y 桩群id
type int N 0-默认查出全部tab, 1-空闲tab 2-预约tab 3-充电 4-不可用tab 5-未放回tab
socSort String N 查询可充电电枪列表时有效 默认 DESC(降序) (可传 DESC 或ASC)

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id
  6. "name":"康桥诺富特充电站",//桩群名称
  7. "address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址
  8. "totalGunNum":2,//总枪数
  9. "totalDcGunNum":1,//总直流枪数
  10. "totalAcGunNum":1,//总交流枪数
  11. "freeGuns":{
  12. "statusGunNum":2,//当前状态总枪数
  13. "statusDcGunNum":1,//当前状态直流枪数
  14. "statusAcGunNum":1,//当前状态交流枪数
  15. "guns":[{
  16. "stakeId":"1204007161100067"//桩ID
  17. "stakeCode":8 //桩编号
  18. "gunNo":1 //枪号
  19. "power":20 //功率
  20. "soc":"25",// 充电桩状态下 当前枪的剩余电量
  21. "otherInfo":"可充电" //枪的其他信息 空闲--可充电 预约--预约时间 充电-充电时长 不可用-不可用原因 枪未放回-null
  22. },...]
  23. }, //空闲枪情况
  24. "appointmentGuns":{...}, //预约枪情况 同空闲枪情况
  25. "chargeGuns":{...}, //充电枪情况 同空闲枪情况
  26. "unuseGuns":{...}, //不可用枪情况 同空闲枪情况
  27. "unbackGuns":{...} //未放回枪情况表 同空闲枪情况
  28. }
  29. }

2.9 根据名称搜索桩群

不传cityId或者传空则是全国, 此处和产品沟通后不分页

接口地址:
POST /group/searchGroup.pam

请求参数:

参数 数据类型 必填 参数说明
name String Y 桩群名称
cityId String N 城市id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "id":"028082526B5A49A0A635B2F87EAF2BBC",
  6. "name":"康桥诺富特充电站",
  7. "address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店"
  8. },..]
  9. }

2.10 城市各状态电桩列表

接口地址:
POST /group/cityStakes.pam

请求参数:

参数 数据类型 必填 参数说明
stakeType int N 桩状态类型 1-空闲(默认),2-使用,3-离线,4-告警
cityId String Y 城市id
page int N 当前页码 默认1
size int N 当前页数据量 默认10

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "total":10,
  6. "pageNum":1,
  7. "pageSize":8,
  8. "pages":6,
  9. "size":8,
  10. "list":[
  11. {
  12. "id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id
  13. "name":"康桥诺富特充电站",//桩群名称
  14. "address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址
  15. "totalStakeNum":2,//总桩数
  16. "totalDcStakeNum":1,//总直流桩数
  17. "totalAcStakeNum":1,//总交流桩数
  18. "statusStakeNum":2,//当前状态总桩数
  19. "statusDcStakeNum":1,//当前状态直流桩数
  20. "statusAcStakeNum":1//当前状态交流桩数
  21. }
  22. ]
  23. }
  24. }

2.11. 桩群电桩桩详情

接口地址:
POST /group/groupStakeDetail.pam

请求参数:

参数 数据类型 必填 参数说明
groupId String Y 桩群id
type int N 0-默认查出全部tab, 1-空闲tab 2-使用tab 3-离线tab 4-告警tab

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data: {
  5. "id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id
  6. "name":"康桥诺富特充电站",//桩群名称
  7. "address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址
  8. "totalStakeNum":2,//总桩数
  9. "totalDcStakeNum":1,//总直流桩数
  10. "totalAcStakeNum":1,//总交流桩数
  11. "freeStakes":{
  12. "statusStakeNum":2,//当前状态总桩数
  13. "statusDcStakeNum":1,//当前状态直流桩数
  14. "statusAcStakeNum":1,//当前状态交流桩数
  15. "stakes":[{
  16. "stakeId":"1204007161100067"//枪ID
  17. "stakeCode":8 //枪编号
  18. "power":20 //功率
  19. "otherInfo":"可充电" //桩的其他信息 空闲--可充电 使用-使用类型 离线-离线时长 故障-故障时间
  20. }...]
  21. }, //空闲桩情况
  22. "useStakes":{...}, //使用桩情况 同空闲桩情况
  23. "offlineStakes":{...}, //离线桩情况 同空闲桩情况
  24. "alarmStakes":{...} //告警桩情况 同空闲桩情况
  25. }
  26. }

2.12 城市桩群列表

用于新建工单时选择桩群

接口地址:
POST /group/groups.pam

请求参数:

参数 数据类型 必填 参数说明
cityId String Y 城市id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "id":"xax"//桩群id
  6. "name":"港汇充电站"//桩群名
  7. },...
  8. ]
  9. }

2.13 桩群下桩列表

用于选择自编号

接口地址:
POST /group/groupStakes.pam

请求参数:

参数 数据类型 必填 参数说明
groupId String Y 桩群id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "id":""//桩id
  6. "attr":1,//类型 直流交流
  7. "codeself":"2",//自编码
  8. "power":320.10,
  9. "stakeId":""//桩编号
  10. "version":"3.2.2",
  11. "supplier":"盛宏"//厂家
  12. },...
  13. ]
  14. }

三、工单相关业务

3.1 我的待处理任务工单数

接口地址:
POST /order/orderNum.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:3
  5. }

3.1.1 我的待处理任务数(新)

接口地址:
POST /order/taskNum.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "orderNum":10,//待处理工单数量
  6. "alarmNum":5//待处理的告警数
  7. }
  8. }

3.2 任务处理列表(工单列表)

接口地址:
POST /order/orders.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id
type int N 列表类型type 1-待处理(默认) 2-已处理
page int N 分页参数
size int N 分页参数

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. "id":1,//工单id
  7. "workOrderno":"GDH-001100",//工单号
  8. "groupName":"xxx",//桩群名称
  9. "stakeCode":"1",//
  10. "alarmCategoryName":"网络异常",//故障类型
  11. "createrId":"001",//创建人id
  12. "createrName":"张三",//新建人员
  13. "timeDesc":"20:30"//时间描述
  14. "status":1//工单状态:0-新建 1-确认中 3-已完成 4-已撤回
  15. "statusDesc":"李四确认中"//状态描述
  16. },..
  17. ]
  18. }

3.3 正常工单详情

接口地址:
POST /order/orderDetail.pam

请求参数:

参数 数据类型 必填 参数说明
workOrderno String Y 工单号

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data: {
  5. "id":2,//工单id
  6. "workOrderno":"GDH-100",//工单号
  7. "status":1,
  8. "statusDesc":xxx,//状态描述
  9. "createrId":"001",//创建人id
  10. "createrName":"xxx",//上报人
  11. "nextHandleId":"002",//下一步(当前操作人)id
  12. "nextHandleName":"xxx",//下一步(当前操作人)名称
  13. "alarmTime":2017/09,//故障时间
  14. "alarmCategoryName":"2",//故障类型
  15. "attr":"交流",//类型 交流直流
  16. "power":20.2,//功率
  17. "stakeVersion":"xx",//桩版本
  18. "stakeId":"xxx"//桩编号
  19. "stakeCode":"1",//
  20. "groupName":"ccc",//所属桩群
  21. "supplier":"xx"//厂家
  22. "alarmContent":"xxx"//故障信息
  23. "alarmPics":"http://locahost/xx/xx.jpg"//故障图片
  24. "records":[{//操作流程
  25. "id":1,
  26. "operateUserName":"z张三",
  27. "timeDesc":"时间描述",//时间描述
  28. "status":1,//工单操作记录状态:0-新建 1-确认中 2-已转交 3-已完成(1是可以转化为2的)4-已撤回
  29. "operateDesc":"操作说明",//操作说明
  30. "operatePics":"xxx"//
  31. },...
  32. ]
  33. }
  34. }

3.4 撤回工单

接口地址:
POST /order/revoke.pam

请求参数:

参数 数据类型 必填 参数说明
workOrderno String Y 工单号
userId String Y 用户id
revokeReason String Y 撤回理由

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data://见撤回工单详情
  5. }

3.5 处理人员公司列表

用于选择处理人员

接口地址:
POST /order/companies.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "id":"1010",
  6. "name":"合肥子公司"
  7. },...
  8. ]
  9. }

3.6 处理人员列表

接口地址:
POST /order/users.pam

请求参数:

参数 数据类型 必填 参数说明
companyId String Y 公司id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "userId":"",
  6. "roleType":2,
  7. "roleTypeName":"运维主管"
  8. },...
  9. ]
  10. }

3.7 确认工单

接口地址:
POST /order/confirm.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id
workOrderno String Y 工单号
operateDesc String Y 操作说明
operatePics String N 图片路径,多图片英文逗号分隔

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{}//工单详情
  5. }

3.8转交工单

接口地址:
POST /order/transfer.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id
workOrderno String Y 工单号
transferId String Y 转移用户id
operateDesc String Y 操作说明
operatePics String N 图片路径,多图片英文逗号分隔

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{}//工单详情
  5. }

3.9 我发起的工单列表

POST /order/mineLaunched.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id
page int N 分页参数
size int N 分页参数

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. "id":1,//工单id
  7. "workOrderno":"GDH-001100",//工单号
  8. "groupName":"xxx",//桩群名称
  9. "stakeCode":"1",//
  10. "alarmCategoryName":"网络异常",//故障类型
  11. "createrName":"张三",//新建人员
  12. "timeDesc":"20:30"//时间描述
  13. "status":1//工单状态:0-新建 1-确认中 3-已完成 4-已撤回
  14. "statusDesc":"李四确认中"//状态描述
  15. },..
  16. ]
  17. }

3.10 新建工单

POST /order/build.pam

请求参数:

参数 数据类型 必填 参数说明
createrId String Y 当前用户id
groupId String Y 桩群id
stakeId String Y 桩编码
stakeCode String Y 桩自编号
alarmCategoryId String Y 故障类型
alarmTime Date Y 故障时间 yyyy-MM-dd HH:mm:ss
alarmContent String Y 故障描述
alarmPics String N 故障图片
nextHandleId String N 下一步处理人员id
troubleId String N 关联的告警id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{}//工单详情
  5. }

3.11 工单列表

包含【我处理的】【我发起的】和权限范围类能查看的工单。总部的运维主管/维修主管,能查看所有工单。
接口地址:
POST /order/workOrders.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id
page int N 分页参数
size int N 分页参数

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

3.12 根据桩群名称 搜索工单

接口地址:
POST /order/searchOrders.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 用户id
groupName String Y 桩群名称

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "id": 2,
  6. "workOrderno":"GDH-001",//工单号
  7. "groupName":"港汇桩群",//桩群名
  8. "stakeCode":"2",//桩自编号
  9. "status":1//工单状态
  10. },...
  11. ]
  12. }

3.13 根据条件筛选工单

接口地址:
POST /order/filterOrders.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 当前用户id
cityId String N 城市id
startDate Date N 开始时间 yyyy-MM-dd HH:mm:ss
endDate Date N 结束时间 yyyy-MM-dd HH:mm:ss
alarmCategoryId Integer N 故障类型id
seriesId Integer N 系列id
page int N 分页参数
size int N 分页参数

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. "id":1,//工单id
  7. "workOrderno":"GDH-001100",//工单号
  8. "groupName":"xxx",//桩群名称
  9. "stakeCode":"1",//
  10. "alarmCategoryName":"网络异常",//故障类型
  11. "createrName":"张三",//新建人员
  12. "timeDesc":"20:30"//时间描述
  13. "status":1//工单状态:0-新建 1-确认中 3-已完成 4-已撤回
  14. "statusDesc":"李四确认中"//状态描述
  15. },..
  16. ]
  17. }

3.14 撤回工单详情

接口地址:
POST /order/revokeOrderDetail.pam

请求参数:

参数 数据类型 必填 参数说明
workOrderno String Y 工单号

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "workOrderno":"GDH-001100",//工单号
  6. "revokeReason":"xxx",//撤回理由
  7. "operateUserId":"1lkjadsh",//操作人id
  8. "operateUserName":"张氏",//操作人
  9. "operateTime":"2016-09-08 14:12"//撤回时间
  10. }
  11. }

四、告警相关

4.1 告警列表

接口地址:
POST /alarm/list.pam

请求参数:

参数 数据类型 必填 参数说明
userId int Y 用户id
type int N type 1-待处理(默认) 2-已处理
page int N 分页参数
size int N 分页参数

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[ {
  5. "id":"028082526B5A49A0A635B2F87EAF2BBC",//告警id
  6. "groupName":"康桥诺富特充电站",//桩群名称
  7. "stakeCode":"6",
  8. "alarmDate":"2016-6-6 12:12:20",//告警时间
  9. "alarmmean":""//告警含义
  10. },...
  11. ]
  12. }

4.2告警详情

接口地址:
POST /alarm/detail.pam

请求参数:

参数 数据类型 必填 参数说明
alarmId String Y 告警id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "id":"028082526B5A49A0A635B2F87EAF2BBC",//告警id
  6. "groupName":"康桥诺富特充电站",//桩群名称
  7. "stakeCode":6,
  8. "alarmDate":2,//告警时间
  9. "alarmmean":1,//告警含义
  10. "alarmlevel":1,//告警级别
  11. "alarmsolve":2,//建议处理方式
  12. "currentVersion":"1.1",//当前版本
  13. "lastVersion":"1.2",//最新诚信版本
  14. "groupId":"2",//桩群id
  15. "stakeId":"00001",//桩编号
  16. "workOrderno":"1.2"//关联的工单号
  17. }
  18. }

4.3单个确认告警

接口地址:
POST /alarm/confirm.pam

请求参数:

参数 数据类型 必填 参数说明
alarmId String Y 告警id
userId String Y 当前用户id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

4.4 全部批量确认告警

接口地址:
POST /alarm/batchConfirm.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 当前用户id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

4.5 今日批量确认告警

接口地址:
POST /alarm/todayConfirm.pam

请求参数:

参数 数据类型 必填 参数说明
userId String Y 当前用户id

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

五、报表相关

5.1 桩群利用率

接口地址:
POST /report/totalUseProportion.pam

请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. "total":100,
  6. "openNum":89,
  7. "unopenNum":11
  8. }
  9. }

5.2 子公司桩群利用率

接口地址:
POST /report/subUseProportion.pam

请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "companyName":"合肥子公司",
  6. "openNum":20,
  7. "unopenNum":15
  8. },...
  9. ]
  10. }

二 、二期接口文档及一期修改说明

原接口修改说明

① 登录接口修改(1.1登录)

  1. //返回数据 新增所属公司ID和所属公司名称:
  2. subcompany //所属公司id 总公司为空
  3. subcompanyName //所属公司名称 总公司为空

② 桩群电枪详情接口修改(2.8 桩群电枪详情)

  1. 充电状态的电枪列表中新增SOC字段,
  2. 且可以根据此字段排序socSort

③ 告警详情接口修改 (4.2告警详情)

  1. 告警详情里加入关联的工单号workOrderno,用以判断当前告警是否被处理;
  2. 另外加groupId桩群idstakeId编号,用于新建工单使用;

④ 修改新建工单接口(3.10 新建工单)

  1. 可从告警作为入口新建工单,保持二者的关联关系,
  2. 表单中加入参数 troubleId (告警id 非必填)

⑤ 修改告警列表接口,增加权限控制

  1. 子公司只能查看自己公司的工单,总公司可以查看全部
  2. 前端无需改变,保持传入用户id即可

报表相关接口

6.1-1 工单数量总体 总公司/子公司(三个月内)

接口地址:
POST /report/order/orderNum.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String N 所属子公司 总公司不传或传空

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "monthStr":"11月",
  6. "month":11,
  7. "num":15//完成工单总数量
  8. },...
  9. ]
  10. }

6.1-2 某月工单数量报表详情

接口地址:
POST /report/order/orderNumDetails.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String Y 子公司id
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "subcompany":"asaa",//子公司id
  6. "subcompanyName":"合肥子公司",//子公司名称
  7. "num":15//完成工单总数量
  8. },...
  9. ]
  10. }

6.1-3 某月子公司工单报表详情

接口地址:
POST /report/order/subOrderNumDetails.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String Y 子公司id
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "name":"张三",//完成工单的人
  6. "num":15//完成工单总数量
  7. },...
  8. ]
  9. }

6.2-1 处理时长/响应时长/故障时长 总体(总公司/子公司 三个月内)

接口地址:
POST /report/order/orderDuration.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String N 子公司id 总公司不传或者传空
type int N 类型 1-处理时长(默认) 2-响应时长 3-故障时长

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "nonthStr":"11月",//月份
  6. "month":11,
  7. "num":3.5//平均时长 h
  8. },...
  9. ]
  10. }

6.2-2 某月处理时长/响应时长/故障时长详情

接口地址:
POST /report/order/orderDurationDetail.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String Y 子公司id
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "subcompany":"xx001",//子公司id
  6. "subcompanyName":"合肥子公司",//子公司名称
  7. "num":15.2//平均时长 h
  8. },...
  9. ]
  10. }

6.2-3 子公司某月处理时长/响应时长/故障时长详情

接口地址:
POST /report/order/subOrderDurationDetail.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String Y 子公司id
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "name":"张三",//完成工单的人
  6. "num":1.5// 平均时长
  7. },...
  8. ]
  9. }

6.3-1 故障类型总体情况统计

接口地址:
POST /report/order/alarmCategory.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String N 子公司id 总公司不传或者传空
categoryId String Y 故障类型编码

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "nonthStr":"11月",//月份
  6. "month":11,
  7. "num":3.5,//平均时长
  8. "time":2.5,//平均次数
  9. },...
  10. ]
  11. }

6.3-2 某月故障类型详情统计

接口地址:
POST /report/order/alarmCategoryDetail.pam

请求参数:

参数 数据类型 必填 参数说明
categoryId String Y 故障类型编码
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "subcompanyName":"11月",//子公司名称
  6. "subcompany":'xasd554',//子公司id
  7. "num":3.5,//平均时长
  8. "time":2.5,//平均次数
  9. },...
  10. ]
  11. }

6.3-3 某月子公司故障类型详情统计

接口地址:
POST /report/order/subAlarmCategoryDetail.pam

请求参数:

参数 数据类型 必填 参数说明
categoryId String Y 故障类型编码
subCompany String Y 子公司id
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "stakeCode":"01",//桩自编号
  6. "groupName":"01",//桩群名称
  7. "num":1.5,// 平均次数
  8. "time":1.5// 平均时长
  9. },...
  10. ]
  11. }

6.4-1 电损报表 -桩群

接口地址:
POST /report/order/groupElecLossRate.pam

请求参数:

参数 数据类型 必填 参数说明
yearMonth String Y 年月, 形如:2017-11 (yyyy-MM)
subCompany String N 子公司id 总公司不传或传空
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "groupName":"01",//桩群名称
  6. "num":1.5//电损率
  7. },...
  8. ]
  9. }

6.4-2 电损报表 -桩

接口地址:
POST /report/order/stakeElecLossRate.pam

请求参数:

参数 数据类型 必填 参数说明
yearMonth String Y 年月, 形如:2017-11 (yyyy-MM)
subCompany String N 子公司id 总公司不传或传空
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "stakeCode":"01",//桩自编号
  6. "groupName":"01",//桩群名称
  7. "num":1.5//电损率
  8. },...
  9. ]
  10. }

6.5-1 桩群利用率-开放/未开放数量

接口地址:
POST /report/order/groupOpend.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String N 子公司id 总公司不传或传空

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "allCount":100,//总数
  6. "openCount":98,//开放数
  7. "closeCount":2//未开放数
  8. },...
  9. ]
  10. }

6.5-2 桩群利用率-时长/功率利用率

接口地址:
POST /report/order/usedRate.pam

请求参数:

参数 数据类型 必填 参数说明
type int N 1-时长 2-功率
year int Y 年份 如 2017
month int Y 月份 如11
subCompany String N 子公司id 总公司不传或传空
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "groupName":'合肥港汇桩群',//桩群名称
  6. "num":2.5//利用率
  7. },...
  8. ]
  9. }

6.6-1 设备故障率-桩群 (某月的)

接口地址:
POST /report/order/groupEquipmentAlarm.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String N 子公司id 总公司不传或传空
yearMonth String Y 年月 形如 2017-11
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "groupName":'xx桩群',//桩群名
  6. "accident":2//故障率
  7. },...
  8. ]
  9. }

6.6-2 设备故障率-桩(某月的)

接口地址:
POST /report/order/stakeEquipmentAlarm.pam

请求参数:

参数 数据类型 必填 参数说明
subCompany String N 子公司id 总公司不传或传空
month int Y 月份
sort String N 排序: DESC(默认)或 ASC

运行时异常

code 错误原因 返回消息

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. "groupName":'xx桩群',//桩群名
  6. "stakeCode":'02',//桩编号
  7. "accident":2//故障率
  8. },...
  9. ]
  10. }

三、sql

建表语句

工单表:

  1. CREATE TABLE `cloud_work_order` (
  2. `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '工单id',
  3. `work_orderno` varchar(32) NOT NULL COMMENT '工单号',
  4. `group_id` varchar(32) DEFAULT NULL COMMENT '桩群id',
  5. `stake_id` varchar(32) DEFAULT NULL COMMENT '桩编号',
  6. `stake_code` varchar(32) DEFAULT NULL COMMENT '桩自编号',
  7. `alarm_category_id` bigint DEFAULT NULL COMMENT '工单故障类型表id',
  8. `creater_id` varchar(32) DEFAULT NULL COMMENT '创建人(上报人)id',
  9. `creater_name` varchar(64) DEFAULT NULL COMMENT '创建者姓名',
  10. `next_handle_id` varchar(32) DEFAULT NULL COMMENT '下一步处理人员id',
  11. `next_handle_name` varchar(200) DEFAULT NULL COMMENT '下一步处理人员名称',
  12. `create_time` bigint(20) DEFAULT NULL COMMENT '创建时间(上报时间)',
  13. `modify_time` bigint(20) DEFAULT NULL COMMENT '修改时间,最后操作时间',
  14. `alarm_time` bigint(20) DEFAULT NULL COMMENT '故障时间',
  15. `alarm_content` varchar(512) DEFAULT NULL COMMENT '故障内容',
  16. `alarm_pics` varchar(512) DEFAULT NULL COMMENT '故障图片,多个使用逗号分隔',
  17. `status` tinyint(1) DEFAULT '0' COMMENT '工单状态:0-新建 1-确认中 2-已完成 3-已撤回',
  18. `revoke_reason` varchar(512) DEFAULT NULL COMMENT '撤回理由',
  19. `trouble_id` varchar(32) DEFAULT NULL COMMENT '告警表id -预留 下期可能会做',
  20. PRIMARY KEY (`id`),
  21. UNIQUE KEY `work_orderno_unique` (`work_orderno`)
  22. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='工单表'

工单状态记录表

  1. CREATE TABLE `cloud_work_order_record` (
  2. `id` int(11) NOT NULL AUTO_INCREMENT COMMENT 'id',
  3. `work_orderno` varchar(32) DEFAULT NULL COMMENT '工单号',
  4. `operate_user_id` varchar(32) DEFAULT NULL COMMENT '操作用户id',
  5. `operate_user_name` varchar(64) DEFAULT NULL COMMENT '操作用户名称',
  6. `create_time` bigint(20) DEFAULT NULL COMMENT '新建时间',
  7. `operate_time` bigint(20) DEFAULT NULL COMMENT '操作时间',
  8. `operate_desc` varchar(512) DEFAULT NULL COMMENT '操作说明',
  9. `operate_pics` varchar(512) DEFAULT NULL COMMENT '操作图片,逗号分隔',
  10. `status` tinyint(1) DEFAULT '0' COMMENT '工单操作记录状态:0-新建 1-确认中 2-已转交 3-已完成(1是可以转化为2的)',
  11. PRIMARY KEY (`id`)
  12. ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8 COMMENT='工单扭转记录表'

新增电桩故障类型 ,用于新建工单

  1. INSERT INTO cloud_sys_code(CODE, NAME, corder, remark) VALUES (103002005,'电桩故障类型',0,'用于新建工单');
  2. INSERT INTO cloud_sys_code(CODE, NAME, corder) VALUES (103002005001,'断网',1);
  3. INSERT INTO cloud_sys_code(CODE, NAME, corder) VALUES (103002005002,'设备故障',2);
  4. INSERT INTO cloud_sys_code(CODE, NAME, corder) VALUES (103002005003,'系统数据异常',3);
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注