考勤打卡原始记录
接口说明: 获取考勤打卡原始记录信息。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/attendance/clockrecords
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeIds | List<String> | N | 员工id列表，不传默认查当前时间段全公司员工 |
| startTime | Long | Y | 打卡记录查询开始时间戳(精确到秒) |
| endTime | Long | Y | 打卡记录查询结束时间戳(精确到秒) |
| pageNo | Integer | N | 查询页码，默认从0开始，翻页+1 |
| pageSize | Integer | N | 每页数据条数，每页数量不超过100条，默认100条 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | PageResult |
Y | 操作成功时返回分页打卡记录 |
PageResult
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| totalPageSize | Long | Y | 总页数 |
| hasMore | boolean | Y | 是否有下一页 true-有，false-没有 |
| pageNo | Integer | Y | 当前页 |
| pageSize | Integer | Y | 每页显示条数 |
| result | List<AttendanceRecord> | Y | 打卡记录详情 |
AttendanceRecord
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| clockRecordId | String | Y | 打卡记录ID |
| employeeId | String | Y | 员工ID |
| clockTime | String | Y | 员工打卡时间 |
| source | Integer | Y | 打卡来源 0-GPS打卡、1-外勤打卡、2-考勤机打卡、3-批量上传打卡、4-补打卡、5-wifi打卡、6-钉钉打卡、7-其他打卡、8-人脸GPS打卡、9-人脸wifi打卡、10-企业微信打卡、11-云之家打卡 |
| remark | String | Y | 打卡备注信息 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/clockrecords?sign=jWdRnK%2BgeCEs5LwM%2BvLRVlgXbHk%3D
请求Body示例:
{
"employeeIds": [
"805f8c65825b4c2fae96f64ffb7d6901",
"90d0c1c87b99402aab3d772d8e6201ed"
],
"pageSize": 10,
"startTime": 1606788500,
"endTime": 1606788600,
"pageNo": 0,
"timestamp": 1606790486325
}
SDK请求示例(java):
AttendanceClockRecordsRequest request = new AttendanceClockRecordsRequest(access_token());
request.setEmployeeIds(Arrays.asList("805f8c65825b4c2fae96f64ffb7d6901", "90d0c1c87b99402aab3d772d8e6201ed"));
request.setPageNo(0);
request.setPageSize(10);
request.setStartTime(1606788500L);
request.setEndTime(1606788600L);
OpenapiResponse<PageResult<AttendanceRecord>> pageResult = XrxsAttendanceService.clockRecords(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"totalPageSize": 1,
"pageNo": 0,
"pageSize": 10,
"result": [
{
"employeeId": "805f8c65825b4c2fae96f64ffb7d6901",
"clockRecordId": "920d78d35e984c01bb83d0906d999e07",
"clockTime": 1606788555,
"source": 2,
"remark": ""
},
{
"employeeId": "805f8c65825b4c2fae96f64ffb7d6901",
"clockRecordId": "73219384e3f3457c8180c983f2859403",
"clockTime": 1606788556,
"source": 7,
"remark": ""
},
{
"employeeId": "90d0c1c87b99402aab3d772d8e6201ed",
"clockRecordId": "edf9c86af2e344b8bbb081fc37f708cd",
"clockTime": 1606788556,
"source": 7,
"remark": ""
}
],
"hasMore": false
}
}