批量打卡
接口说明: 批量上传员工打卡记录。上传的打卡记录可以在考勤的原始打卡记录中查看。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/attendance/batchclock
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
| clockData | List<BatchClockModel> | Y | 批量打卡数据，每次上传的打卡数据不能超过100条 |
BatchClockModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工id |
| clockTime | Integer | Y | 打卡时间戳(精确到秒) |
| source | Integer | N | 打卡来源，，1-考勤机打卡，2-其他来源，3-openApi打卡，4-外部系统打卡，5-门禁打卡。默认是其他来源 |
| remark | String | N | 备注，最大50个字符 |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/batchclock?sign=QjmsBu9%2B4dfmCewl7Q2Qjxn%2F%2Fg4%3D
请求Body示例:
{
"clockData": [
{
"clockTime": 1606788556,
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"source": 2,
"remark":"测试备注"
},
{
"clockTime": 1606788556,
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"source": 2,
"remark":"测试备注"
}
],
"timestamp": 1606789238905
}
SDK请求示例(java):
AttendanceBatchClockRequest request = new AttendanceBatchClockRequest(access_token());
BatchClockModel model1 = new BatchClockModel();
model1.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
model1.setClockTime(1606788556);
model1.setRemark("测试备注");
model1.setSource(2);
BatchClockModel model2 = new BatchClockModel();
model2.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
model2.setClockTime(1606788556);
model2.setRemark("测试备注");
model2.setSource(2);
request.setClockData(Arrays.asList(model1, model2));
OpenapiResponse<Void> response = XrxsAttendanceService.batchClock(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": null
}