@xuduochoua
2018-04-10T07:36:39.000000Z
字数 19523
阅读 1616
接口 winsky原型地址
内网: http://192.168.10.37:9900/yunweiapp/
外网 http://120.234.32.67:9900/yunweiapp/#g=1&p=更新记录
返回JSON格式说明
{code:0,//返回码 0-默认 成功msg:"",//错误码说明信息data:null//接口需求的具体数据 或List 或String 等}
base_url
http://192.168.0.36:10081/pamapi
简单的安全
对所有请求参数进行AES统一加密,加密key为sAl(@E20-*2+!#$bc95对所用返回数据进行AES统一加密,加密key为sAl(@E20-*2+!#$bc95后期可考虑token + 签名方式 + restful风格
通用错误码说明
401 : 未登录400 : 请求参数错误
接口地址:
POST /system/login.pam
根据角色判断属于全国还是城市 根据子公司城市判断所属城市
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| username | string | Y | 账户 |
| password | string | Y | 密码 |
错误码说明
| code | 错误原因 | 返回消息 |
|---|---|---|
| 609 | 密码错误 | 密码错误 |
| 608 | 不存的用户 | 不存在的用户 |
| 607 | 用户被禁用 | 用户被禁用 |
响应结果:
{"code": 0, //0 - 接口调用成功,其他值表示失败"message": "","data": {"id":"xxx","username;":"xxx","roleType":1,//1-客服,2-总部运维专员,3-总部运维主管,4-维修主管,5-运维专员,6-运维主管,"roleName":"客服","cityId":null,//当为总部角色的时候 返回空"cityName":"全国""subcompany":654asd61", //所属公司id 总公司为空"subcompanyName::"合肥子公司" //所属公司名称 总公司为空}}
接口地址:
POST /system/forget.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| mobile | String | Y | 手机号 |
| username | String | Y | 用户名 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 608 | 不存在的用户 | 不存在的用户或者用户名和手机号不匹配 |
| 607 | 用户被禁用 | 用户被禁用 |
响应结果:
{code:0,msg:"",data:null}
接口地址:
POST /syetem/updatePassword.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
| oldPassword | String | Y | 旧密码 |
| newPassword | String | Y | 新密码 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 609 | 密码错误 | 密码错误 |
| 608 | 不存的用户 | 不存在的用户 |
| 607 | 用户被禁用 | 用户被禁用 |
响应结果:
{code:0,msg:"",data:null}
接口地址:
POST /system/logout.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:null}
省列表,省当中包含市列表
接口地址:
POST /system/cities.pam
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":"101101","name":"安徽省","cities":[{"id":"10101001","name":"合肥市"},....]},....]}
接口地址:
POST /system/alarmCategories.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":1,"name":"网络异常"},{...}]}
接口地址:
POST /system/stakeModels.pam 或者/group/groupStakeSeries.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":1,"name":"盛宏交流"},{...}]}
接口地址:
GET /system/cityCompanys.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| companyId | String | Y | 当前用户管辖的公司id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":1,"name":"公司1"},{...}]}
接口地址:
POST /group/allGroupSurvey.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"free":1,//空闲数"use":1,//使用数"offline":1,//离线数"alarm":1//告警数}}
接口地址:
POST /group/cityGroupSurvey.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| cityId | String | Y | 城市id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data: {"free":1,//空闲数"use":1,//使用数"offline":1,//离线数"alarm":1//告警数}}
接口地址:
POST /group/allGunSurvey.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"free":1,//空闲数"appointment":1,//预约数"charge":1,//充电数"unuse":1,//未使用数"unback":1//未放回数}}
接口地址:
POST /group/cityGunSurvey.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| cityId | String | Y | 城市id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"free":1,//空闲数"appointment":1,//预约数"charge":1,//充电数"unuse":1,//未使用数"unback":1//未放回数}}
接口地址:
POST /group/allStakeDistribution.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"provinceId":"101001340",//省code"provinceName":"安徽省",//省命名"distributions":[{"cityId":"101001340010","cityName":"合肥市","num":11},{"cityId":"101001340020","cityName":"芜湖市","num":11},...]},..]}
接口地址:
POST /group/allGunDistribution.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"provinceId":"101001340",//省code"provinceName":"安徽省",//省命名"distributions":[{"cityId":"101001340010","cityName":"合肥市","num":11},{"cityId":"101001340020","cityName":"芜湖市","num":11},...]},..]}
接口地址:
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 | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"total":10,"pageNum":1,"pageSize":8,"pages":6,"size":8,list: [{"id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id"name":"康桥诺富特充电站",//桩群名称"address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址"totalGunNum":2,//总枪数"totalDcGunNum":1,//总直流枪数"totalAcGunNum":1,//总交流枪数"statusGunNum":2,//当前状态总枪数"statusDcGunNum":1,//当前状态直流枪数"statusAcGunNum":1//当前状态交流枪数},...]}}
接口地址:
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 | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id"name":"康桥诺富特充电站",//桩群名称"address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址"totalGunNum":2,//总枪数"totalDcGunNum":1,//总直流枪数"totalAcGunNum":1,//总交流枪数"freeGuns":{"statusGunNum":2,//当前状态总枪数"statusDcGunNum":1,//当前状态直流枪数"statusAcGunNum":1,//当前状态交流枪数"guns":[{"stakeId":"1204007161100067"//桩ID"stakeCode":8 //桩编号"gunNo":1 //枪号"power":20 //功率"soc":"25",// 充电桩状态下 当前枪的剩余电量"otherInfo":"可充电" //枪的其他信息 空闲--可充电 预约--预约时间 充电-充电时长 不可用-不可用原因 枪未放回-null},...]}, //空闲枪情况"appointmentGuns":{...}, //预约枪情况 同空闲枪情况"chargeGuns":{...}, //充电枪情况 同空闲枪情况"unuseGuns":{...}, //不可用枪情况 同空闲枪情况"unbackGuns":{...} //未放回枪情况表 同空闲枪情况}}
不传cityId或者传空则是全国, 此处和产品沟通后不分页
接口地址:
POST /group/searchGroup.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| name | String | Y | 桩群名称 |
| cityId | String | N | 城市id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":"028082526B5A49A0A635B2F87EAF2BBC","name":"康桥诺富特充电站","address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店"},..]}
接口地址:
POST /group/cityStakes.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| stakeType | int | N | 桩状态类型 1-空闲(默认),2-使用,3-离线,4-告警 |
| cityId | String | Y | 城市id |
| page | int | N | 当前页码 默认1 |
| size | int | N | 当前页数据量 默认10 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"total":10,"pageNum":1,"pageSize":8,"pages":6,"size":8,"list":[{"id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id"name":"康桥诺富特充电站",//桩群名称"address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址"totalStakeNum":2,//总桩数"totalDcStakeNum":1,//总直流桩数"totalAcStakeNum":1,//总交流桩数"statusStakeNum":2,//当前状态总桩数"statusDcStakeNum":1,//当前状态直流桩数"statusAcStakeNum":1//当前状态交流桩数}]}}
接口地址:
POST /group/groupStakeDetail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| groupId | String | Y | 桩群id |
| type | int | N | 0-默认查出全部tab, 1-空闲tab 2-使用tab 3-离线tab 4-告警tab |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data: {"id":"028082526B5A49A0A635B2F87EAF2BBC",//桩群id"name":"康桥诺富特充电站",//桩群名称"address":"上海市浦东新区秀浦路3188弄1号康桥诺富特酒店",//桩群地址"totalStakeNum":2,//总桩数"totalDcStakeNum":1,//总直流桩数"totalAcStakeNum":1,//总交流桩数"freeStakes":{"statusStakeNum":2,//当前状态总桩数"statusDcStakeNum":1,//当前状态直流桩数"statusAcStakeNum":1,//当前状态交流桩数"stakes":[{"stakeId":"1204007161100067"//枪ID"stakeCode":8 //枪编号"power":20 //功率"otherInfo":"可充电" //桩的其他信息 空闲--可充电 使用-使用类型 离线-离线时长 故障-故障时间}...]}, //空闲桩情况"useStakes":{...}, //使用桩情况 同空闲桩情况"offlineStakes":{...}, //离线桩情况 同空闲桩情况"alarmStakes":{...} //告警桩情况 同空闲桩情况}}
用于新建工单时选择桩群
接口地址:
POST /group/groups.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| cityId | String | Y | 城市id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":"xax"//桩群id"name":"港汇充电站"//桩群名},...]}
用于选择自编号
接口地址:
POST /group/groupStakes.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| groupId | String | Y | 桩群id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":""//桩id"attr":1,//类型 直流交流"codeself":"2",//自编码"power":320.10,"stakeId":"",//桩编号"version":"3.2.2","supplier":"盛宏"//厂家},...]}
接口地址:
POST /order/orderNum.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:3}
接口地址:
POST /order/taskNum.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"orderNum":10,//待处理工单数量"alarmNum":5//待处理的告警数}}
接口地址:
POST /order/orders.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
| type | int | N | 列表类型type 1-待处理(默认) 2-已处理 |
| page | int | N | 分页参数 |
| size | int | N | 分页参数 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":1,//工单id"workOrderno":"GDH-001100",//工单号"groupName":"xxx",//桩群名称"stakeCode":"1",//"alarmCategoryName":"网络异常",//故障类型"createrId":"001",//创建人id"createrName":"张三",//新建人员"timeDesc":"20:30"//时间描述"status":1//工单状态:0-新建 1-确认中 3-已完成 4-已撤回"statusDesc":"李四确认中"//状态描述},..]}
接口地址:
POST /order/orderDetail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| workOrderno | String | Y | 工单号 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data: {"id":2,//工单id"workOrderno":"GDH-100",//工单号"status":1,"statusDesc":xxx,//状态描述"createrId":"001",//创建人id"createrName":"xxx",//上报人"nextHandleId":"002",//下一步(当前操作人)id"nextHandleName":"xxx",//下一步(当前操作人)名称"alarmTime":2017/09,//故障时间"alarmCategoryName":"2",//故障类型"attr":"交流",//类型 交流直流"power":20.2,//功率"stakeVersion":"xx",//桩版本"stakeId":"xxx"//桩编号"stakeCode":"1",//"groupName":"ccc",//所属桩群"supplier":"xx"//厂家"alarmContent":"xxx"//故障信息"alarmPics":"http://locahost/xx/xx.jpg"//故障图片"records":[{//操作流程"id":1,"operateUserName":"z张三","timeDesc":"时间描述",//时间描述"status":1,//工单操作记录状态:0-新建 1-确认中 2-已转交 3-已完成(1是可以转化为2的)4-已撤回"operateDesc":"操作说明",//操作说明"operatePics":"xxx"//},...]}}
接口地址:
POST /order/revoke.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| workOrderno | String | Y | 工单号 |
| userId | String | Y | 用户id |
| revokeReason | String | Y | 撤回理由 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data://见撤回工单详情}
用于选择处理人员
接口地址:
POST /order/companies.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":"1010","name":"合肥子公司"},...]}
接口地址:
POST /order/users.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| companyId | String | Y | 公司id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"userId":"","roleType":2,"roleTypeName":"运维主管"},...]}
接口地址:
POST /order/confirm.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
| workOrderno | String | Y | 工单号 |
| operateDesc | String | Y | 操作说明 |
| operatePics | String | N | 图片路径,多图片英文逗号分隔 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{}//工单详情}
接口地址:
POST /order/transfer.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
| workOrderno | String | Y | 工单号 |
| transferId | String | Y | 转移用户id |
| operateDesc | String | Y | 操作说明 |
| operatePics | String | N | 图片路径,多图片英文逗号分隔 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{}//工单详情}
POST /order/mineLaunched.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
| page | int | N | 分页参数 |
| size | int | N | 分页参数 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":1,//工单id"workOrderno":"GDH-001100",//工单号"groupName":"xxx",//桩群名称"stakeCode":"1",//"alarmCategoryName":"网络异常",//故障类型"createrName":"张三",//新建人员"timeDesc":"20:30"//时间描述"status":1//工单状态:0-新建 1-确认中 3-已完成 4-已撤回"statusDesc":"李四确认中"//状态描述},..]}
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 | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{}//工单详情}
包含【我处理的】【我发起的】和权限范围类能查看的工单。总部的运维主管/维修主管,能查看所有工单。
接口地址:
POST/order/workOrders.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
| page | int | N | 分页参数 |
| size | int | N | 分页参数 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:null}
接口地址:
POST /order/searchOrders.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 用户id |
| groupName | String | Y | 桩群名称 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id": 2,"workOrderno":"GDH-001",//工单号"groupName":"港汇桩群",//桩群名"stakeCode":"2",//桩自编号"status":1//工单状态},...]}
接口地址:
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 | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"id":1,//工单id"workOrderno":"GDH-001100",//工单号"groupName":"xxx",//桩群名称"stakeCode":"1",//"alarmCategoryName":"网络异常",//故障类型"createrName":"张三",//新建人员"timeDesc":"20:30"//时间描述"status":1//工单状态:0-新建 1-确认中 3-已完成 4-已撤回"statusDesc":"李四确认中"//状态描述},..]}
接口地址:
POST /order/revokeOrderDetail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| workOrderno | String | Y | 工单号 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"workOrderno":"GDH-001100",//工单号"revokeReason":"xxx",//撤回理由"operateUserId":"1lkjadsh",//操作人id"operateUserName":"张氏",//操作人"operateTime":"2016-09-08 14:12"//撤回时间}}
接口地址:
POST /alarm/list.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | int | Y | 用户id |
| type | int | N | type 1-待处理(默认) 2-已处理 |
| page | int | N | 分页参数 |
| size | int | N | 分页参数 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[ {"id":"028082526B5A49A0A635B2F87EAF2BBC",//告警id"groupName":"康桥诺富特充电站",//桩群名称"stakeCode":"6","alarmDate":"2016-6-6 12:12:20",//告警时间"alarmmean":""//告警含义},...]}
接口地址:
POST /alarm/detail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| alarmId | String | Y | 告警id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"id":"028082526B5A49A0A635B2F87EAF2BBC",//告警id"groupName":"康桥诺富特充电站",//桩群名称"stakeCode":6,"alarmDate":2,//告警时间"alarmmean":1,//告警含义"alarmlevel":1,//告警级别"alarmsolve":2,//建议处理方式"currentVersion":"1.1",//当前版本"lastVersion":"1.2",//最新诚信版本"groupId":"2",//桩群id"stakeId":"00001",//桩编号"workOrderno":"1.2"//关联的工单号}}
接口地址:
POST /alarm/confirm.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| alarmId | String | Y | 告警id |
| userId | String | Y | 当前用户id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:null}
接口地址:
POST /alarm/batchConfirm.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 当前用户id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:null}
接口地址:
POST /alarm/todayConfirm.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| userId | String | Y | 当前用户id |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:null}
接口地址:
POST /report/totalUseProportion.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:{"total":100,"openNum":89,"unopenNum":11}}
接口地址:
POST /report/subUseProportion.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"companyName":"合肥子公司","openNum":20,"unopenNum":15},...]}
1.1登录)
//返回数据 新增所属公司ID和所属公司名称:subcompany //所属公司id 总公司为空subcompanyName //所属公司名称 总公司为空
2.8 桩群电枪详情)
充电状态的电枪列表中新增SOC字段,且可以根据此字段排序socSort
4.2告警详情)
告警详情里加入关联的工单号workOrderno,用以判断当前告警是否被处理;另外加groupId桩群id和stakeId编号,用于新建工单使用;
3.10 新建工单)
可从告警作为入口新建工单,保持二者的关联关系,表单中加入参数 troubleId (告警id 非必填)
子公司只能查看自己公司的工单,总公司可以查看全部前端无需改变,保持传入用户id即可
接口地址:
POST /report/order/orderNum.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | N | 所属子公司 总公司不传或传空 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"monthStr":"11月","month":11,"num":15//完成工单总数量},...]}
接口地址:
POST /report/order/orderNumDetails.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | Y | 子公司id |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"subcompany":"asaa",//子公司id"subcompanyName":"合肥子公司",//子公司名称"num":15//完成工单总数量},...]}
接口地址:
POST /report/order/subOrderNumDetails.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | Y | 子公司id |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"name":"张三",//完成工单的人"num":15//完成工单总数量},...]}
接口地址:
POST /report/order/orderDuration.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | N | 子公司id 总公司不传或者传空 |
| type | int | N | 类型 1-处理时长(默认) 2-响应时长 3-故障时长 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"nonthStr":"11月",//月份"month":11,"num":3.5//平均时长 h},...]}
接口地址:
POST /report/order/orderDurationDetail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | Y | 子公司id |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"subcompany":"xx001",//子公司id"subcompanyName":"合肥子公司",//子公司名称"num":15.2//平均时长 h},...]}
接口地址:
POST /report/order/subOrderDurationDetail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | Y | 子公司id |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"name":"张三",//完成工单的人"num":1.5// 平均时长},...]}
接口地址:
POST /report/order/alarmCategory.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | N | 子公司id 总公司不传或者传空 |
| categoryId | String | Y | 故障类型编码 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"nonthStr":"11月",//月份"month":11,"num":3.5,//平均时长"time":2.5,//平均次数},...]}
接口地址:
POST /report/order/alarmCategoryDetail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| categoryId | String | Y | 故障类型编码 |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"subcompanyName":"11月",//子公司名称"subcompany":'xasd554',//子公司id"num":3.5,//平均时长"time":2.5,//平均次数},...]}
接口地址:
POST /report/order/subAlarmCategoryDetail.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| categoryId | String | Y | 故障类型编码 |
| subCompany | String | Y | 子公司id |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"stakeCode":"01",//桩自编号"groupName":"01",//桩群名称"num":1.5,// 平均次数"time":1.5// 平均时长},...]}
接口地址:
POST /report/order/groupElecLossRate.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| yearMonth | String | Y | 年月, 形如:2017-11 (yyyy-MM) |
| subCompany | String | N | 子公司id 总公司不传或传空 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"groupName":"01",//桩群名称"num":1.5//电损率},...]}
接口地址:
POST /report/order/stakeElecLossRate.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| yearMonth | String | Y | 年月, 形如:2017-11 (yyyy-MM) |
| subCompany | String | N | 子公司id 总公司不传或传空 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"stakeCode":"01",//桩自编号"groupName":"01",//桩群名称"num":1.5//电损率},...]}
接口地址:
POST /report/order/groupOpend.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | N | 子公司id 总公司不传或传空 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"allCount":100,//总数"openCount":98,//开放数"closeCount":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 | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"groupName":'合肥港汇桩群',//桩群名称"num":2.5//利用率},...]}
接口地址:
POST /report/order/groupEquipmentAlarm.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | N | 子公司id 总公司不传或传空 |
| yearMonth | String | Y | 年月 形如 2017-11 |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"groupName":'xx桩群',//桩群名"accident":2//故障率},...]}
接口地址:
POST /report/order/stakeEquipmentAlarm.pam
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| subCompany | String | N | 子公司id 总公司不传或传空 |
| month | int | Y | 月份 |
| sort | String | N | 排序: DESC(默认)或 ASC |
运行时异常
| code | 错误原因 | 返回消息 |
|---|
响应结果:
{code:0,msg:"",data:[{"groupName":'xx桩群',//桩群名"stakeCode":'02',//桩编号"accident":2//故障率},...]}
建表语句
CREATE TABLE `cloud_work_order` (`id` int(11) NOT NULL AUTO_INCREMENT COMMENT '工单id',`work_orderno` varchar(32) NOT NULL COMMENT '工单号',`group_id` varchar(32) DEFAULT NULL COMMENT '桩群id',`stake_id` varchar(32) DEFAULT NULL COMMENT '桩编号',`stake_code` varchar(32) DEFAULT NULL COMMENT '桩自编号',`alarm_category_id` bigint DEFAULT NULL COMMENT '工单故障类型表id',`creater_id` varchar(32) DEFAULT NULL COMMENT '创建人(上报人)id',`creater_name` varchar(64) DEFAULT NULL COMMENT '创建者姓名',`next_handle_id` varchar(32) DEFAULT NULL COMMENT '下一步处理人员id',`next_handle_name` varchar(200) DEFAULT NULL COMMENT '下一步处理人员名称',`create_time` bigint(20) DEFAULT NULL COMMENT '创建时间(上报时间)',`modify_time` bigint(20) DEFAULT NULL COMMENT '修改时间,最后操作时间',`alarm_time` bigint(20) DEFAULT NULL COMMENT '故障时间',`alarm_content` varchar(512) DEFAULT NULL COMMENT '故障内容',`alarm_pics` varchar(512) DEFAULT NULL COMMENT '故障图片,多个使用逗号分隔',`status` tinyint(1) DEFAULT '0' COMMENT '工单状态:0-新建 1-确认中 2-已完成 3-已撤回',`revoke_reason` varchar(512) DEFAULT NULL COMMENT '撤回理由',`trouble_id` varchar(32) DEFAULT NULL COMMENT '告警表id -预留 下期可能会做',PRIMARY KEY (`id`),UNIQUE KEY `work_orderno_unique` (`work_orderno`)) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='工单表'
CREATE TABLE `cloud_work_order_record` (`id` int(11) NOT NULL AUTO_INCREMENT COMMENT 'id',`work_orderno` varchar(32) DEFAULT NULL COMMENT '工单号',`operate_user_id` varchar(32) DEFAULT NULL COMMENT '操作用户id',`operate_user_name` varchar(64) DEFAULT NULL COMMENT '操作用户名称',`create_time` bigint(20) DEFAULT NULL COMMENT '新建时间',`operate_time` bigint(20) DEFAULT NULL COMMENT '操作时间',`operate_desc` varchar(512) DEFAULT NULL COMMENT '操作说明',`operate_pics` varchar(512) DEFAULT NULL COMMENT '操作图片,逗号分隔',`status` tinyint(1) DEFAULT '0' COMMENT '工单操作记录状态:0-新建 1-确认中 2-已转交 3-已完成(1是可以转化为2的)',PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8 COMMENT='工单扭转记录表'
INSERT INTO cloud_sys_code(CODE, NAME, corder, remark) VALUES (103002005,'电桩故障类型',0,'用于新建工单');INSERT INTO cloud_sys_code(CODE, NAME, corder) VALUES (103002005001,'断网',1);INSERT INTO cloud_sys_code(CODE, NAME, corder) VALUES (103002005002,'设备故障',2);INSERT INTO cloud_sys_code(CODE, NAME, corder) VALUES (103002005003,'系统数据异常',3);