打卡记录分页列表

接口地址:/openapi/attendanceRecord/queryPage

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "contractNo": "",
  "endDate": "",
  "keyword": "",
  "projectId": 0,
  "startDate": "",
  "orgId":0,
  "phoneNumber":""
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
attendanceRecordPageQueryPfRequest AttendanceRecordPageQueryPfRequest body true AttendanceRecordPageQueryPfRequest AttendanceRecordPageQueryPfRequest
  orgId 组织-公司 false integer(int64)
  contractNo 合同号 false string
  endDate 结束时间 false string(date-time)
  keyword 查询关键词 false string
  projectId 工地ID false integer(int64)
  startDate 开始时间 false string(date-time)
  phoneNumber 电话号码 false string
pageNo pageNo query false integer(int32)
pageSize pageSize query false integer(int32)

响应状态:

状态码 说明 schema
200 OK R«open-platform 分页简单对象«AttendanceRecordPfPageVo»»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data open-platform 分页简单对象«AttendanceRecordPfPageVo» open-platform 分页简单对象«AttendanceRecordPfPageVo»
  current 当前页 integer(int64)
  records 查询数据列表 array AttendanceRecordPfPageVo
    id 记录id long
    attendanceType 类型 string
    date 日期 string
    firstPicUrl 首次打卡图片 string
    firstRecord 首次打卡时间 string
    lastPicUrl 最后打卡图片 string
    lastRecord 最后打卡时间 string
    userId 打卡人id string
    faceUrl 打卡人底库照片 string
    name 姓名 string
    orgName 组织名称 string
    positionName 岗位 string
    projectId 项目id string
    contractNo 项目合同号 string
    projectName 项目名称 string
    totalMin 时长 integer
    workerType 工种 string
    workerTypeName 工种名称 string
    phoneNumber 电话 string
    serialNumber 序列号（如多个不同设备“,”隔开） string
    specialCode 第三方编码 string
    manualCheckCode 考勤核验结果CODE string NOT或CORRECT或WRONG
    manualCheckCodeDesc 考勤核验结果中文描述 string
  size 每页显示条数 integer(int64)
  total 总数 integer(int64)
message string
successful boolean

响应示例:

{
    "code": 0,
    "data": {
        "current": 0,
        "records": [
            {
                "id":0,
                "attendanceType": "",
                "date": "",
                "firstPicUrl": "",
                "firstRecord": "",
                "lastPicUrl": "",
                "lastRecord": "",
                "userId":"",
                "name": "",
                "orgName": "",
                "positionName": "",
                "projectId": "",
                "contractNo":"",
                "projectName": "",
                "totalMin": 0,
                "workerType": "",
                "workerTypeName": "",
                "specialCode":""
            }
        ],
        "size": 0,
        "total": 0
    },
    "message": "",
    "successful": true
}

手动打卡

接口地址:/openapi/attendanceRecord/addAttendanceRecord

请求方式:POST

请求数据类型:multipart/form-data

响应数据类型:*/*

接口描述:

请求参数:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
userPhone 打卡人电话号码 form-data true string
puchTime 打卡时间（时间戳毫秒） form-data true integer(int64)
imageFile 照片文件 form-data true file
projectId 工地Id（与合同号二选一） form-data false integer(int64)
contractNo 工地合同号（与工地id二选一） form-data false string

响应状态:

状态码 说明 schema
200 OK R«boolean»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data boolean
message string
successful boolean

响应示例:

{
    "code": 0,
    "data": true,
    "message": "",
    "successful": true
}
作者：admin  创建时间：2021-07-06 11:16
最后编辑：admin  更新时间：2026-01-29 21:48