1.4.6.1. 获取打卡记录

查询指定时间段内考勤设备的打卡记录，分页返回结果。建议当对账异常时才调用该接口，打卡记录以接收推送的方式为主，并存储到第三方的数据库。

接口限制及注意事项【重要】：

  1. 只能查询45天之内的数据;
  2. 查询时间段不能超过31天;
  3. 查询时间段不能跨月查询;

Request:

POST /v1.0/device/event/punchRecord/getByPage
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702

{
    "lang": "zh-cn",
    "usr": "username",
    "pwd": "password",
    "payload": {
        "curPage": 1,
        "pageSize": 10,
        "params": {
            "startTime": 1492617600,
            "endTime": 1492790400,
            "pushStartTime": 1492617600,
            "pushEndTime": 1492790400
        }
    }
}
参数名 类型 必填 描述
curPage Integer N 分页查询条件，分页页码，默认第1页
pageSize Integer N 分页查询条件，分页大小，默认每页10条，不超过20条
startTime Long N 打卡开始Unix时间戳，精确到秒（默认查询条件）
endTime Long N 打卡截止Unix时间戳，精确到秒，为空时默认当前时间（默认查询条件）
pushStartTime Long N 开始Unix时间戳，精确到秒，此处指设备将记录推送到服务端的时间
pushEndTime Long N 截止Unix时间戳，精确到秒，此处指设备将记录推送到服务端的时间，为空时默认当前时间

注意事项：

本接口支持按打卡时间查询和按记录推送到服务端的时间查询，如果选择按打卡时间查询,请传startTime和endTime；如果选择按记录推送到服务端的时间查询，请传pushStartTime和pushEndTime；startTime和pushStartTime至少一个条件不为空。

Response：

{
    "code": "00000000",
    "mid": "xxxxxxx",
    "message": "success",
    "payload": {
        "totalRecords": 4,
        "curPage": 1,
        "totalPages": 1,
        "pageSize": 10,
        "results": [{
            "sn": "",
            "employeeNo": "",
            "punchTime": 1492617600,
            "iso8601PunchTime": "2019-06-03T09:01:01+08:00",
            "workCode": "",
            "status": "0",
            "pushTime": 1492617600,
            "temperature": "36.50",
            "maskStatus": "1"
        }]
    }
}
参数名 类型 描述
curPage Integer 分页页码
pageSize Integer 分页大小
totalRecords Integer 总记录数
totalPages Integer 总分页数
sn String 打卡设备序列号
employeeNo String 打卡人员编号
punchTime Long 打卡时间戳
iso8601PunchTime String 打卡时间(iso8601标准格式)
workCode String 工作代码
status String 打卡状态，“0” 上班签到，“1” 下班签退，“2” 外出，“3”外出返回，“4” 加班签到，“5” 加班签退，“255” 默认
pushTime String 记录推送到服务器的时间
temperature String 体温。此属性配合设备使用，当设备带体温检测功能才有返回值
maskStatus String 是否佩戴口罩，“0” 未佩戴口罩，“1” 已佩戴口罩。此属性配合设备使用，当设备带口罩检测功能才有返回值

1.4.6.2. 打卡记录校对

  • 对账指定时间段内考勤设备的打卡记录, 返回该时间段内打卡记录总数。建议定期对账，防止数据丢失。

  • 第三方自行验证该时间段内存储的打卡记录数是否一致，不一致则可调用获取打卡记录接口重新获取打卡记录。

POST /v1.0/device/event/punchRecord/verify
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702

{
    "lang": "zh-cn",
    "usr": "username",
    "pwd": "password",
    "payload": {
        "params": {
            "startTime": 1492617600,
            "endTime": 1492790400,
            "pushStartTime": 1492617600,
            "pushEndTime": 1492790400
        }
    }
}
参数名 类型 必填 描述
startTime Long N 打卡开始Unix时间戳，精确到秒（默认查询条件）
endTime Long N 打卡截止Unix时间戳，精确到秒，为空时默认当前时间（默认查询条件）
pushStartTime Long N 开始Unix时间戳，精确到秒，此处指设备将记录推送到服务端的时间
pushEndTime Long N 截止Unix时间戳，精确到秒，此处指设备将记录推送到服务端的时间，为空时默认当前时间

注意事项：

本接口支持按打卡时间查询和按记录推送到服务端的时间查询，如果选择按打卡时间查询,请传startTime和endTime；如果选择按记录推送到服务端的时间查询，请传pushStartTime和pushEndTime；startTime和pushStartTime至少一个条件不为空。

Response：

{
    "code": "00000000",
    "mid": "xxxxxxx",
    "message": "success",
    "payload": {
        "results": {
            "punchRecordSum": 999
        }
    }
}
参数名 类型 描述
punchRecordSum Integer 打卡记录总数

results matching ""

    No results matching ""