电梯维保项目-接口文档

模块一:文件上传

1、工作录像上传

  • 请求地址 :

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

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

  • 请求参数:

    参数名 描述
    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 上传的图片集合
  • 返回值:

    "{\"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
  • 返回值:

    "{\"msg\":\"保存数据成功!\",\"success\":true}"
    

    说明:

    key description
    msg 消息提示
    success 接口处理成功与否

3、获取任务详情

  • 请求地址 : 192.168.1.101:8080/appLiftController/getTaskInfo.do

  • 请求参数:

    参数名 描述
    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
  • 返回值:

    "{\"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:轿厢等)
  • 返回值:

    "{\"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
  • 返回值:

    "{\"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表单子项的集合
    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使用材料的集合
    taskId 任务ID
    adjustment 调整内容
    replaceParts 更换零件

    TLiftRepairSupplies对象属性说明:

    private String partId; 材料ID
    private String num;  材料使用数量
    private float totalMoney; 材料使用总价
    
  • 返回值:

    "{\"msg\":\"保存数据成功!\",\"success\":true}"
    

    说明:

    key description
    msg 消息提示
    success 接口处理成功与否

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

  • 请求地址 : 192.168.1.101:8080/appLiftRepairController/getPartsList.do

  • 请求参数:

    参数名 描述
    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 项目的集合

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

  • 请求地址 : 192.168.1.101:8080/appLiftController/getVendor.do

  • 请求参数:

    参数名 描述
    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
  • 返回值:

    "{\"msg\":\"保存数据成功!\",\"success\":true}"
    

    说明:

    key description
    msg 消息提示
    success 接口处理成功与否

其他

1、实时上传定位

  • 请求地址 : 192.168.1.101:8080/appLoginController/appUserLocation.do

  • 请求参数:

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

    "{\"success\":true,\"msg\":\"保存成功!\"}"
    

    说明:

    key description
    msg 消息提示
    success 接口处理成功与否

Copyright©天津泽瑞科技

你可能感兴趣的:(电梯维保项目-接口文档)