获取打卡记录数据 - 企业微信 API

企业可通过打卡应用Secret调用本接口，获取指定员工指定时间段内的打卡记录数据。
第三方应用可获取应用可见范围内指定员工指定日期的打卡记录数据。

说明：

获取记录时间跨度不超过30天

用户列表不超过100个。若用户超过100个，请分批获取

有打卡记录即可获取打卡数据，与当前”打卡应用”是否开启无关

标准打卡时间只对于固定排班和自定义排班两种类型有效

接口调用频率限制为600次/分钟

文档ID: 14630
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90262
https://open.work.weixin.qq.com/api/doc/90001/90143/94205

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

{ "errcode": 0, "errmsg": "ok", "checkindata": [ { "userid": "james", "groupname": "打卡一组", "checkin_type": "上班打卡", "exception_type": "地点异常", "checkin_time": 1492617610, "location_title": "依澜府", "location_detail": "四川省成都市武侯区益州大道中段784号附近", "wifiname": "办公一区", "notes": "路上堵车，迟到了5分钟", "wifimac": "3c:46:d8:0c:7a:70", "mediaids": [ "WWCISP_G8PYgRaOVHjXWUWFqchpBqqqUpGj0OyR9z6WTwhnMZGCPHxyviVstiv_2fTG8YOJq8L8zJT2T2OvTebANV-2MQ" ], "sch_checkin_time": 1492617610, "groupid": 1, "schedule_id": 0, "timeline_id": 2 }, { "userid": "paul", "groupname": "打卡二组", "checkin_type": "外出打卡", "exception_type": "时间异常", "checkin_time": 1492617620, "location_title": "重庆出口加工区", "location_detail": "重庆市渝北区金渝大道101号金渝大道", "wifiname": "办公室二区", "notes": "", "wifimac": "3c:46:d8:0c:7a:71", "mediaids": [ "WWCISP_G8PYgRaOVHjXWUWFqchpBqqqUpGj0OyR9z6WTwhnMZGCPHxyviVstiv_2fTG8YOJq8L8zJT2T2OvTebANV-2MQ" ], "lat": 30547645, "lng": 104063236, "deviceid": "E5FA89F6-3926-4972-BE4F-4A7ACF4701E2", "sch_checkin_time": 1492617610, "groupid": 2, "schedule_id": 3, "timeline_id": 1 } ] }

请求参数

Query 参数

access_token

必需

调用接口凭证。必须使用打卡应用的secret获取，获取方式参考：文档-获取access_token

示例值:

Body 参数application/json

useridlist

array[string]

必需

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

endtime

integer <int32>

必需

获取打卡记录的结束时间。Unix时间戳

opencheckindatatype

integer <int32>

必需

打卡类型。1：上下班打卡；2：外出打卡；3：全部打卡

starttime

integer <int32>

必需

获取打卡记录的开始时间。Unix时间戳

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

checkindata

array [object {18}]

可选

打卡类型。字符串，目前有：上班打卡，下班打卡，外出打卡

checkin_time

integer <int32>

可选

打卡时间。Unix时间戳

wifiname

string

打卡wifi名称

可选

notes

string

打卡备注

可选

lng

integer <int32>

可选

位置打卡地点经度，是实际经度的1000000倍，与腾讯地图一致采用GCJ-02坐标系统标准

location_detail

string

打卡地点详情

可选

groupid

integer <int32>

可选

规则id，表示打卡记录所属规则的id

userid

string

用户id

可选

groupname

string

打卡规则名称

可选

deviceid

string

打卡设备id

可选

checkin_type

string

可选

打卡类型。字符串，目前有：上班打卡，下班打卡，外出打卡

exception_type

string

可选

异常类型，字符串，包括：时间异常，地点异常，未打卡，wifi异常，非常用设备。如果有多个异常，以分号间隔

location_title

string

打卡地点title

可选

wifimac

string

可选

打卡的MAC地址/bssid

mediaids

array[string]

可选

打卡的附件media_id，可使用media/get获取附件

timeline_id

integer <int32>

可选

时段id，表示打卡记录所属规则中，某一班次中的某一时段的id，如上下班时间为9:00-12:00、13:00-18:00的班次中，9:00-12:00为其中一组时段

schedule_id

integer <int32>

可选

班次id，表示打卡记录所属规则中，所属班次的id

lat

integer <int32>

可选

位置打卡地点纬度，是实际纬度的1000000倍，与腾讯地图一致采用GCJ-02坐标系统标准

sch_checkin_time

integer <int32>

可选

标准打卡时间，指此次打卡时间对应的标准上班时间或标准下班时间

errmsg

string

可选