点点兼职回收机后台接口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
