电梯维保项目-接口文档

2017-11-12 本文已影响0人 Breaker_93

模块一：文件上传

1、工作录像上传

请求地址 :

当type=1维保任务： 192.168.1.101:8080/appLiftController/saveMainPlanVideo.do

当type=2维修任务： 192.168.1.101:8080/appLiftRepairController/saveRepairVideo.do

请求参数：

参数名描述

taskId 任务ID

files 视频文件

参数名	描述
taskId	任务ID
files	视频文件

返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

2、工作拍照上传

请求地址 :

当type=1维保任务： 192.168.1.101:8080/appLiftController/saveMainPlanPic.do

当type=2维修任务：192.168.1.101:8080/aappLiftRepairController/saveRepairPic.do
请求参数：

参数名描述

taskId 任务ID

files 上传的图片集合

参数名	描述
taskId	任务ID
files	上传的图片集合

返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

模块二：签到签退

1、获取今日签到与签退记录

请求地址 : 192.168.1.101:8080/appLoginController/getUserSignToDay.do
请求参数：

参数名描述

userId 用户ID

createRiQi 当日的日期

返回值：

"{\"success\":true,
\"msg\":\"获取数据成功！\",
\"listModel\":[{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"测试  \",\"createDate\":\"Nov 6, 2017 8:08:21 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"1\",\"createRiQi\":\"2017-11-06\"},{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"测试\",\"createDate\":\"Nov 6, 2017 8:08:20 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"2\",\"createRiQi\":\"2017-11-06\"}]}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
listModel	签到和签退记录的集合
listModel[i].type	1：签到；2：签退

2、签到或签退

请求地址 : 192.168.1.101:8080/appLoginController/appUserSign.do

请求参数：

参数名	描述
userId	用户ID
longitude	经度值
latitude	纬度值
address	签到或签退的地址
realName	真实姓名
orgId	公司ID
phoneNo	用户手机号
type	1：执行签到；2：执行签退

返回值：
```
"{\"success\":true,\"msg\":\"保存成功！\"}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

3、获取签到和签退的历史记录

请求地址 : 192.168.1.101:8080/appLoginController/getAppUserSignList.do
请求参数：

参数名描述

userId 用户ID

page 获取第几页

返回值：

"{\"success\":true,
\"msg\":\"获取数据成功！\",
\"listModel\":[{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"测试  \",\"createDate\":\"Nov 6, 2017 8:08:21 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"1\",\"createRiQi\":\"2017-11-06\"},{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"测试\",\"createDate\":\"Nov 6, 2017 8:08:20 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"2\",\"createRiQi\":\"2017-11-06\"}]}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
listModel	签到和签退记录的集合
listModel[i].type	1：签到；2：签退

模块三：维保和维修任务

1、获取任务的列表

请求地址 : 192.168.1.101:8080/appLiftController/getTaskList.do
请求参数：

参数名描述

userId 用户ID

flag 0：新任务；1：历史人物；2：今日任务

page 获取第几页

返回值：

"{\"success\":true,\"msg\":\"获取数据成功！\",\"listModel\":[{\"taskId\":\"402881e55fa9fb00015faa0045c20011\",\"liftLocation\":\"测试-11\",\"address\":\"天津市-市辖区-河东区-12号\",\"taskDate\":\"2017-11-23 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"liftType\":\"2\"},{\"taskId\":\"402881e55fa9fb00015faa00453e000f\",\"liftLocation\":\"测试-11\",\"address\":\"天津市-市辖区-河东区-12号\",\"taskDate\":\"2017-11-15 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"liftType\":\"2\"},{\"taskId\":\"402881e55fa9fb00015faa004473000d\",\"liftLocation\":\"测试-11\",\"address\":\"天津市-市辖区-河东区-12号\",\"taskDate\":\"2017-11-13 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"liftType\":\"2\"}]}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
listModel	任务集合

集合中个条任务项的的属性说明：

taskId:任务ID

liftLocation: 列表项中显示的第一条信息

address：列表项中显示的第二条信息

taskDate：列表项中显示的第二条信息

taskType：1：维保；2：维修

liftType：任务中电梯所属的类型

2、今日任务>执行任务（上传工时）

请求地址 : 192.168.1.101:8080/appLiftController/saveMainTimer.do
请求参数：

参数名描述

outDate 执行的触发时间

taskId 任务ID

userName 用户名

userId 用户ID

参数名	描述
outDate	执行的触发时间
taskId	任务ID
userName	用户名
userId	用户ID

返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

3、获取任务详情

请求地址 : 192.168.1.101:8080/appLiftController/getTaskInfo.do
请求参数：

参数名描述

taskId 任务ID

taskType 1：维保； 2：维修

参数名	描述
taskId	任务ID
taskType	1：维保； 2：维修

返回值：
```
"{\"success\":true,\"msg\":\"获取数据成功！\",\"model\":{\"taskId\":\"402881e55fa9fb00015faa0045c20011\",\"liftLocation\":\"测试-11\",\"address\":\"天津市-市辖区-河东区-12号\",\"taskDate\":\"2017-11-23 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"userName\":\"test\",\"liftType\":\"3\",\"taskPositions\":\"1,2,3,4,5\",\"status\":\"1\"}}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

model 任务的详细信息

任务对象属性说明：

liftType：任务所属电梯的类型；

taskPositions：详细信息中维修点>1：机房，2：轿顶；3：轿厢；4：厅门，5：坑底，

6：上平层外部，7：曳引机，8：控制柜，9：上平层内部，10：倾斜段

11：下平层外部，12：下平层内部,13:机房，14：轿顶；15：轿厢；16：厅门，17：坑底（杂货梯）

4、获取电梯详情

请求地址 : 192.168.1.101:8080/appLiftController/getLiftInfo.do
请求参数：

参数名描述

liftId 电梯ID

参数名	描述
liftId	电梯ID

返回值：

"{\"msg\":\"获取数据成功！\",\"success\":true,\"model\":{\"brandName\":\"12\",\"liftChangeModel\":\"11\",\"liftCode\":\"11\",\"liftFactoryCode\":\"233\",\"liftLocation\":\"测试-11\",\"liftModel\":\"11\",\"liftType\":\"3\",\"liftTypeStr\":\"自动扶梯电梯\",\"mainAddress\":\"天津市-市辖区-和平区-市辖区-12号\",\"mainDepartname\":\"津奥电梯\",\"mainDescription\":\"1111\",\"mainFax\":\"13512311122\",\"mainMobile\":\"13512311122\",\"mainPerson\":\"12\",\"mySpeed\":\"11\",\"myWidth\":\"11\",\"projectAddress\":\"天津市-市辖区-河东区-市辖区-12号\",\"projectName\":\"测试\",\"projectOrgName\":\"津奥电梯\",\"promoteHeight\":\"11\",\"registerCode\":\"123123\",\"tiltAngle\":\"11\",\"transportAbility\":\"11\",\"useSectionLength\":\"11\",\"userAddress\":\"辽宁省-营口市-站前区-营口市-11hao\",\"userDepartname\":\"信诺电梯\",\"userDescription\":\"2222\",\"userFax\":\"13512322211\",\"userMobile\":\"13512322211\",\"userPerson\":\"12344\",\"vendorName\":\"sdd\"}}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
model	电梯的详细信息

电梯对象属性说明：

liftChangeModel：电梯改造后型号；

...（详细见说明文件）

5、获取维保要求列表

请求地址 : 192.168.1.101:8080/appLiftController/getMainPlanBillInfo.do
请求参数：

参数名描述

liftType 根据上一页面所传的lifttype 判断传值（124567 传1 3传2 89传3）

liftPosition 电梯的维保点（如1：机房，2：轿顶；3：轿厢等）

参数名	描述
liftType	根据上一页面所传的lifttype 判断传值（124567 传1 3传2 89传3）
liftPosition	电梯的维保点（如1：机房，2：轿顶；3：轿厢等）

返回值：

"{\"msg\":\"获取数据成功！\",\"success\":true,\"model\":[{\"id\":\"402892865f37bc6e015f37c0bf6b000d\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-1\",\"wbProject\":\"清洁、润滑、环境\",\"wbRequirement\":\"清洁、门窗完好 照明正常\"},{\"id\":\"402892865f37bc6e015f37c14452000f\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-2\",\"wbProject\":\"紧急操作装置\",\"wbRequirement\":\"手动或电动制动器释放\"},{\"id\":\"402892865f37bc6e015f37c186780011\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-3\",\"wbProject\":\"曳引机\",\"wbRequirement\":\"温度、噪音\"},{\"id\":\"402892865f37bc6e015f37c1c1d00013\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-4\",\"wbProject\":\"制动器各销轴\",\"wbRequirement\":\"润滑、动作灵活\"},{\"id\":\"402892865f37bc6e015f37c203c80015\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-5\",\"wbProject\":\"制动器间隙\",\"wbRequirement\":\"打开时（0.125-0.7）\"},{\"id\":\"402892865f37bc6e015f37c26d760017\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-6\",\"wbProject\":\"编码器\",\"wbRequirement\":\"润滑、灵活、电气开关正常\"},{\"id\":\"402892865f37bc6e015f37c2b1740019\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-7\",\"wbProject\":\"控制柜\",\"wbRequirement\":\"清洁、继电器阻值\"},{\"id\":\"402892865f37bc6e015f37c2f114001b\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-8\",\"wbProject\":\"机房温度\",\"wbRequirement\":\"5~40℃\"}]}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
model	对电梯点的维保要求的集合

6、获取工作结果列表

请求地址 : 192.168.1.101:8080/appLiftController/getAttachment.do
请求参数：

参数名描述

planId 任务ID

参数名	描述
planId	任务ID

返回值：

"{\"msg\":\"保存数据成功！\",
\"scans\":[{\"id\":\"12312313\",\"orgId\":\"402892865eeb26fd015eeb37d5490006\",\"orgName\":\"津奥电梯\",\"planId\":\"402892865f759965015f759cbc1b000e\",\"scanContent\":\"402892865f23c442015f23e46ef10020-402892865f283977015f283a6c190003-A4-1\",\"scanDate\":1509546432000,\"scanResult\":\"扫描  轿厢 序号:1 成功\",\"scanUserId\":\"402892865f42099c015f422bd8fa0003\",\"scanUserName\":\"wb123\"}],
\"success\":true,
\"videos\":[{\"id\":\"123131321qweqqe\",\"planId\":\"402892865f759965015f759cbc1b000e\",\"videoDate\":1509602201000,\"videoName\":\"测试123\",\"videoPathVirtual\":\"upload/qrcode/C5B0015D2B0E9331C0C9CA8144948C29.mp4\" ,\"videoPicPath\":\"upload/qrcode/5618ee3eed8ac.jpg\"}],
\"pics\":[{\"id\":\"12312323\",\"picDate\":1509590563000,\"picName\":\"测试（2017.11.02）\",\"picPath\":\"E:\\\\workspace-zeruiIDE\\\\zrkj-plat\\\\zrkj-web\\\\target\\\\zrkj-web\\\\/upload/qrcode/402892865f531241015f53136cb60001BN68m48381.png\",\"picPathVirtual\":\"upload/qrcode/5618ee3eed8ac.jpg\",\"planId\":\"402892865f759965015f759cbc1b000e\"}]}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
scans	扫描表单结果的集合
videos	上传视频结果的集合
pics	上传图片结果的结合

模块四：电子填单

1、维保填单提交

请求地址 : 192.168.1.101:8080/appLiftController/saveMainPlanBill.do

请求参数：

参数名	描述
liftMainPlanBills	List<TLiftMainPlanBill>表单子项的集合
planId	任务ID
userId	用户ID
userName	用户名

TLiftMainPlanBill对象属性说明：

private String typeId;  表单的子项的ID
private String bc1;   该子项的第一条信息
private String bc2;   ...
private String bc3;   ...
private String bc4;   ...
private String bc5;
private String bc6;

返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

2、维修填单提交

请求地址 : 192.168.1.101:8080/appLiftRepairController/saveRepairBill.do
请求参数：

参数名描述

liftRepairSupplies List<TLiftRepairSupplies>使用材料的集合

taskId 任务ID

adjustment 调整内容

replaceParts 更换零件
TLiftRepairSupplies对象属性说明：
```
private String partId; 材料ID
private String num;  材料使用数量
private float totalMoney; 材料使用总价
```
返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

参数名	描述
liftRepairSupplies	List<TLiftRepairSupplies>使用材料的集合
taskId	任务ID
adjustment	调整内容
replaceParts	更换零件

3、维修电子填单>获取材料列表

请求地址 : 192.168.1.101:8080/appLiftRepairController/getPartsList.do
请求参数：

参数名描述

liftId 要维修的电梯的ID

page 获取第几页

参数名	描述
liftId	要维修的电梯的ID
page	获取第几页

返回值：
```
"{\"msg\":\"获取数据成功！\",\"success\":true,\"model\":[{\"id\":\"402892865f1ae2a7015f1ae434930006\",\"partPrice\":123,\"partUnit\":1,\"partsCode\":\"123\",\"partsName\":\"133r\",\"partsType\":\"wee\"}]}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

model 材料对象的集合

每个材料对象的属性说明：

id：材料ID

partPrice：单价

partUnit：单位只_1,根_2,台_3,套_4

partsName: 材料名称

模块五：电梯新增

1、获取组织机构或使用单位的列表

请求地址 : 192.168.1.101:8080/appLiftController\getLiftOrgInfo3.do
请求参数（无）

返回值：

"{\"msg\":\"保存数据成功！\",\"success\":true,\"model\":[{\"name\":\"津奥电梯\",\"pId\":\"1\",\"id\":\"402892865eeb26fd015eeb37d5490006\"},{\"name\":\"信诺电梯\",\"pId\":\"1\",\"id\":\"402892865ef1dfa9015ef1ed9a0f0006\"}]}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
model	组织机构或使用单位的对象集合

2、获取项目的列表

请求地址 : 192.168.1.101:8080/appLiftController/getProject.do
请求参数：

参数名描述

orgId 公司ID
返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true,\"model\":[]}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

model 项目的集合

参数名	描述
orgId	公司ID

3、根据供应商名称模糊搜索电梯

请求地址 : 192.168.1.101:8080/appLiftController/getVendor.do
请求参数：

参数名描述

vendorName 供应商名称的关键字

参数名	描述
vendorName	供应商名称的关键字

返回值：

"{\"msg\":\"获取数据成功！\",\"success\":true,\"model\":[{\"address\":\"\",\"brandCode\":\"ca\",\"brandName\":\"12\",\"brandType\":\"qa\",\"city\":\"\",\"createDate\":1507987504000,\"createUser\":\"系统管理员\",\"id\":\"402892865f1b0d53015f1b0f3c1e000a\",\"partsBrandList\":[{\"id\":\"402892865f1b6bf7015f1b6c91bf0003\",\"tLiftParts\":{\"brandId\":\"402892865efe9cb8015efea8d2b90005\",\"brandName\":\"奥的斯\",\"createDate\":1507984684000,\"createUser\":\"系统管理员\",\"id\":\"402892865f1ae2a7015f1ae434930006\",\"partPrice\":123,\"partUnit\":1,\"partsCode\":\"123\",\"partsName\":\"133r\",\"partsType\":\"wee\",\"vendorId\":\"402892865f1ae2a7015f1ae35a990003\",\"vendorName\":\"123\"},\"tLiftVendorBrand\":{\"$ref\":\"$.model[0]\"}}],\"person\":\"aa\",\"phone\":\"13511266611\",\"province\":\"辽宁省\",\"vendorName\":\"sdd\"}]}"

说明：

key	description
msg	消息提示
success	接口处理成功与否
model	电梯对象的集合

4、新增直梯或杂货梯

请求地址 : 192.168.1.101:8080/appLiftController/saveLiftApp.do

请求参数：

参数名	描述
userId	用户ID
userName	用户名
orgId	公司ID
createUser	用户真实名字
createOrgId	所选的组织机构ID
projectId	所选的项目ID
useOrgId	所选的使用单位ID
maintenanceOrgId	所选的维保单位ID
registerCode	注册代码
brandId	电梯品牌ID
liftCode	电梯编号
liftLocation	电梯位置
liftType	电梯类型ID
liftFactoryCode	电梯出场编码
liftModel	电梯型号
liftChangeModel	电梯改造后的型号
controlMode	控制方式
ratedLoad	额定载重
ratedSpeed	额定速度
layer	层数
station	站
door	门

返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

5、新增扶梯

请求地址 : 192.168.1.101:8080/appLiftController/saveLiftApp.do

请求参数：

参数名	描述
userId	用户ID
userName	用户名
orgId	公司ID
createUser	用户真实名字
createOrgId	所选的组织机构ID
projectId	所选的项目ID
useOrgId	所选的使用单位ID
maintenanceOrgId	所选的维保单位ID
registerCode	注册代码
brandId	电梯品牌ID
liftCode	电梯编号
liftLocation	电梯位置
liftType	电梯类型ID
liftFactoryCode	电梯出场编码
liftModel	电梯型号
liftChangeModel	电梯改造后的型号
controlMode	控制方式
mySpeed	名义速度
tiltAngle	倾斜角度
promoteHeight	提升高度
myWidth	名义宽度
transportAbility	输送能力
useSectionLength	使用区段长度

返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

模块六：二维码扫描

1、维修或维保扫码

请求地址 :

当type=1维保任务： 192.168.1.101:8080/appLiftRepairController/saveRepairScan.do

当type=2维修任务： 192.168.1.101:8080/appLiftController/saveMainScan.do
请求参数：

参数名描述

userName 用户名

userId 用户ID

orgId 公司ID

orgName 公司名称

scanContent 扫描结果

taskId 任务ID

参数名	描述
userName	用户名
userId	用户ID
orgId	公司ID
orgName	公司名称
scanContent	扫描结果
taskId	任务ID

返回值：
```
"{\"msg\":\"保存数据成功！\",\"success\":true}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

其他

1、实时上传定位

请求地址 : 192.168.1.101:8080/appLoginController/appUserLocation.do
请求参数：

参数名描述

longitude 经度

latitude 纬度

address 实时地址

realName 真实姓名

orgId 公司ID

phoneNo 手机号

参数名	描述
longitude	经度
latitude	纬度
address	实时地址
realName	真实姓名
orgId	公司ID
phoneNo	手机号

返回值：
```
"{\"success\":true,\"msg\":\"保存成功！\"}"
```
说明：

key description

msg 消息提示

success 接口处理成功与否

电梯维保项目-接口文档

模块一：文件上传

1、工作录像上传

2、工作拍照上传

模块二：签到签退

1、获取今日签到与签退记录

2、签到或签退

3、获取签到和签退的历史记录

模块三：维保和维修任务

1、获取任务的列表

2、今日任务>执行任务（上传工时）

3、获取任务详情

4、获取电梯详情

5、获取维保要求列表

6、获取工作结果列表

模块四：电子填单

1、维保填单提交

2、维修填单提交

3、维修电子填单>获取材料列表

模块五：电梯新增

1、获取组织机构或使用单位的列表

2、获取项目的列表

3、根据供应商名称模糊搜索电梯

4、新增直梯或杂货梯

5、新增扶梯

模块六：二维码扫描

1、维修或维保扫码

其他

1、实时上传定位

猜你喜欢

热点阅读

参数名	描述
userId	用户ID
flag	0：新任务；1：历史人物；2：今日任务
page	获取第几页