1. 考勤明细
考勤明细管理
1.1. 分页查询考勤明细
基础信息
路径: /v1/api/attendance/detail/page
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
startDate | string | 是 | 开始时间 | |
endDate | string | 是 | 结束时间 | |
personName | string | 否 | 人员名称,模糊搜索 | |
personCode | string | 否 | 人员编号,模糊搜索 | |
personUuids | array | 否 | 人员UUID列表 | |
|─ | string | |||
source | integer | 否 | 来源类型 1 :考勤点 2 :补卡 |
|
orgUuid | string | 否 | 部门 | |
attendancePointName | string | 否 | 考勤点位名称,模糊搜索 | |
attendancePointTypes | array | 否 | 考勤点位类型 0 :非考勤点 1 :上班考勤点 2 :下班考勤点 3 :上下班考勤点 |
|
|─ | integer | |||
pointZoneUuid | string | 否 | 点位区域 | |
pageNum | integer | 否 | 1 | 页码,从1开始 当前页码,不传默认1 |
pageSize | integer | 否 | 20 | 页面大小 分页大小,不传默认20 |
Body示例:
{
"pageNum": 1,
"orgUuid": "0",
"pointZoneUuid": "0",
"pageSize": 2,
"startDate": 1684684800000,
"endDate": 1687276799000
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─pageNum | integer | 是 | 页码,从1开始 | |
|─pageSize | integer | 是 | 页面大小 | |
|─total | integer | 是 | 总记录数 | |
|─list | array | 否 | ||
|─ | object | |||
|─uuid | string | 是 | 明细UUID | |
|─source | integer | 是 | 数据来源;1:设备原始记录;2:手动考勤处理 | |
|─personUuid | string | 是 | 人员UUID | |
|─personCode | string | 是 | 人员编号 | |
|─personName | string | 是 | 人员姓名 | |
|─orgUuid | string | 是 | 部门UUID | |
|─orgName | string | 是 | 部门名称 | |
|─attendancePointUuid | string | 是 | 考勤点UUID | |
|─attendancePointName | string | 是 | 考勤点名称 | |
|─attendancePointType | integer | 是 | 考勤点类型 | |
|─pointZoneUuid | string | 是 | 考勤点所属区域UUID | |
|─pointZoneName | string | 是 | 考勤点所属区域名称 | |
|─snapshotUri | string | 是 | 抓拍图 | |
|─punchTime | string | 是 | 打卡时间 |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"attendancePointName": "C4H-数据拉取门禁点",
"attendancePointType": 3,
"attendancePointUuid": "f88b09824cc245eb80bca852aaaa3c82",
"orgName": "默认部门",
"orgUuid": "0",
"personCode": "13026100668",
"personName": "xiongzichao",
"personUuid": "6ce6866601cf46ac859beb17f552aa67",
"pointZoneName": "默认区域",
"pointZoneUuid": "0",
"punchTime": 1687256076000,
"snapshotUri": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vd3Vrb25nLW1lZ2xpbms=-12410737e1d33f7eb01606e6072dd01f",
"source": 1,
"uuid": "a3de2be6-5a29-40e4-8a5f-fec8bd7de700"
},
{
"attendancePointName": "C4H-数据拉取门禁点",
"attendancePointType": 3,
"attendancePointUuid": "f88b09824cc245eb80bca852aaaa3c82",
"orgName": "默认部门",
"orgUuid": "0",
"personCode": "13026100668",
"personName": "xiongzichao",
"personUuid": "6ce6866601cf46ac859beb17f552aa67",
"pointZoneName": "默认区域",
"pointZoneUuid": "0",
"punchTime": 1687256076000,
"snapshotUri": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vd3Vrb25nLW1lZ2xpbms=-d48758b08338b12fada3ef3608e900f7",
"source": 1,
"uuid": "d0a9500f-72ec-4199-a7fc-8e957b536311"
}
],
"pageNum": 1,
"pageSize": 2,
"total": 4555
},
"msg": "成功"
}