点点兼职回收机后台接口API

Note:该文档采用Markdown语法编辑,已发布到简书,可访问https://www.jianshu.com/p/d630f39e62c0

1新增用户登录记录

1.1用户刷卡登录记录实现说明

在用户刷卡之后，调用getUserMessageByCardNo接口查询用户信息时同步完成新增用户登录记录的功能。
修改getUserMessageByCardNo接口，增加新增用户登录记录的功能。

1.2用户刷微信登录记录实现说明

在用户使用微信扫码之后，调用getUserMessageByUserId接口查询用户信息时同步完成新增用户登录记录的功能。
修改getUserMessageByUserId接口，增加新增用户登录记录的功能。

2批量新增空白刷卡记录

2.1接口说明

批量添加空白卡刷卡记录

2.2接口地址

    http://IP:Port/app/addBatchNewSwipe

2.3访问方式

    POST

2.4参数说明

    参数为json数据,请求要求Context-type:application/json
    {"machineCode":"53100007","promoterId":1,"cardCodes":["AABBCCDD","AABBCCEE","AABBCCFF"]}
    machineCode:回收机Code,
    promoterId:地推员Id,
    cardCodes:卡号列表

2.5返回结果

反馈结果示例如下:
    {
        "status": 200,
        "message":"操作成功",
        "total":1,
        "data":[{"cardCode":"AABBCCGG","reason":"该卡今日已登记"},
                {"cardCode":"AABBCCDD","reason":"查无此卡"},
                {"cardCode":"AABBCCDD","reason":"查无此卡"}] 
    }
状态码如下：
    200:操作成功
    400:[参数缺失]
    500:系统报错
数据项说明：
    cardCode:记录失败的卡号
    reason:失败原因,[已发放,查无此卡],
        已发放表示该卡号已使用。
        查无此卡表示该卡信息在系统内不存在为外部卡。

3工作人员上岗

3.1接口说明

提供工作人员上岗信息上报功能。
同一小区重复上岗返回[重复上岗],不更新用户考勤信息。
在前一考勤信息未结束的情况下，在另外的小区上岗，系统将前一次考勤结束，设置前一个考勤为离岗，同时开启当前小区的到岗。

3.2接口地址

    http://IP:Port/app/startWork

3.3访问方式

    POST

3.4参数说明

    参数为json数据,请求要求Context-type:application/json
    {"machineCode":"53100007","workerId":1,"roleId":1}
    machineCode:回收机Code,
    workerId:工作人员Id,
    roleId:工作人员角色Id

3.5返回结果

反馈结果示例如下：
    {
        "status": 200,
        "message":"上岗成功",
        "total":1,
        "data": {
                    "workerId":1,
                    "attendanceStatus":1,
                    "startDatetime":"2019-03-01 08:23:00",
                    "endDatetime":""
                }
    }
状态码如下：
    200:上岗成功
    202:[重复上岗,工作人员、回收机不存在或角色不对应]
    400:[参数缺失]
    500:系统报错
数据项说明：
    promoterId:地推员Id;
    attendanceStatus:考勤状态,1为上岗,-1为离岗;
    startDatetime:到岗时间；
    endDatetime:离岗时间。

4工作人员离岗

4.1接口说明

提供工作人员离岗信息上报功能。
离岗成功的反馈[离岗成功]
同一小区重复重复岗返回[离岗成功],更新最新的离岗信息。
在最近一次的考勤记录不是小区的情况下，当前小区考勤信息的情况下不允许离岗，返回[未在该小区上岗]

4.2接口地址

    http://IP:Port/app/endWork

4.3访问方式

    POST

4.4参数说明

    参数为json数据,请求要求Context-type:application/json
    {"machineCode":"53100007","workerId":1,"roleId":1}
    machineCode:回收机Code,
    workerId:工作人员Id,
    roleId:工作人员角色Id

4.5返回结果

反馈结果示例如下：
    {
        "status": 200,
        "message":"离岗成功",
        "total":1,
        "data": {
                    "workerId":1,
                    "attendanceStatus":-1,
                    "startDatetime":"2019-03-01 08:23:00",
                    "endDatetime":"2019-03-01 18:23:00"
                }
    }
状态码如下：
    200:离岗成功
    202:[未在该小区上岗,工作人员、回收机不存在或角色不对应]
    400:[参数缺失]
    500:系统报错
数据项说明：
    promoterId:地推员Id;
    attendanceStatus:考勤状态,1为上岗,-1为离岗;
    startDatetime:到岗时间；
    endDatetime:离岗时间。

5静默升级

5.1静默升级后台服务调整说明

1.表t_rrp_wechat_status增加升级标记字段update_flag,升级时间update_datetime。
    update_flag为1标识需要升级，为2表示不需要升级。
    update_datetime为升级的时间，在该事件点执行静默升级。
2.调整addHandMessage接口，反馈中增加updateFlag和updateDatetime数据项
3.调整t_rrp_wechat_status表对应的model。

6回收机办卡

6.1回收机办卡后台服务调整说明

调整selfHandleCard接口，增加接口参数adminId。
adminId:地推员id，
同时还需要完成以下步骤
1.需要判断该卡是否在空白卡记录中存在，若存在则删除空白卡记录。
2.判断该卡在卡库中是否存在，若存在则维护其状态为已发放。
3.需要完成绑卡记录表t_card_bind_record的维护。
4.处理t_rrp_rrpuser表中demo_flag字段为null的问题。

7回收机取现

7.1回收机取现后台服务调整说明

1.调整fetchBalance接口
需要完善取现记录表t_rrp_withdraws_record的新增字段，
    包括
        card_id，
        card_code，
        operationer_id，
        operationer_type，
        flow_number
        online