获取设备打卡数据

POST

/cgi-bin/hardware/get_hardware_checkin_data

服务端API第三方应用开发

可通过此接口，获取考勤设备上产生的所有原始打卡记录，包括未被打卡应用记录的不符合打卡规则的记录。
第三方应用可获取应用可见范围内员工在考勤设备上产生的所有原始打卡记录，包括未被打卡应用记录的不符合打卡规则的记录。

1.
获取记录时间跨度不超过一个月
2.
用户列表不超过100个。若用户超过100个，请分批获取
3.
获取的是通过考勤设备打卡的原始记录，不包含企业微信app手机打卡的记录
4.
userid无效时，忽略该参数，不报错

权限说明:

企业需要使用“打卡”secret所获取的accesstoken来调用（获取方式参考：文档-获取access_token）；

第三方应用需具有“打卡->获取考勤机打卡原始数据”权限

文档ID: 35023
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/95141

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/hardware/get_hardware_checkin_data?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"filter_type":1,"starttime":1492617600,"endtime":1492790400,"useridlist":["james","paul"]}'

响应示例

{
  "errcode": 0,
  "checkindata": [
    {
      "checkin_time": 0,
      "device_name": "string",
      "device_sn": "string",
      "userid": "string"
    }
  ],
  "errmsg": "string"
}

请求参数

Query 参数

access_token

必需

调用接口凭证。第三方需要通过用户明确授权后才可以调用该接口。获取企业access_token方式参考：获取企业凭证

示例值:

Body 参数application/json

filter_type

integer <int32>

可选

过滤类型，1表示按打卡时间过滤，2表示按设备上传打卡记录的时间过滤，默认值是1

useridlist

array[string]

必需

需要获取打卡记录的用户列表

endtime

integer <int32>

必需

Unix时间戳，当filter_type为1时，表示打卡的结束时间；当filter_type为2时，表示设备上传记录的结束时间

starttime

integer <int32>

必需

Unix时间戳，当filter_type为1时，表示打卡的开始时间；当filter_type为2时，表示设备上传记录的开始时间

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

checkindata

array [object {4}]

可选

checkin_time

integer <int32>

可选

打卡时间。Unix时间戳

device_name

string

打卡设备名

可选

device_sn

string

打卡设备的sn

可选

userid

string

用户id

可选

errmsg

string

可选

修改于 2022-01-14 04:25:48

为打卡人员排班

审批流程引擎