获取打卡数据

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckindata?access_token=ACCESS_TOKEN

请求示例:

{
   "opencheckindatatype": 3,
   "starttime": 1492617600,
   "endtime": 1492790400,
   "useridlist": ["james","paul"]
}

参数说明:

参数 必须 说明
access_token 调用接口凭证。企业必须使用打卡应用的Secret获取access_token
opencheckindatatype 打卡类型。1:上下班打卡;2:外出打卡;3:全部打卡
starttime 获取打卡记录的开始时间。Unix时间戳
endtime 获取打卡记录的结束时间。Unix时间戳
useridlist 需要获取打卡记录的用户列表
  1. 获取记录时间跨度不超过30天
  2. 用户列表不超过100个。若用户超过100个,请分批获取
  3. 有打卡记录即可获取打卡数据,与当前”打卡应用”是否开启无关

返回结果 :

{
   "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"]
    },{
        "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"
    }]
}

参数说明:

参数 说明
userid 用户id
groupname 打卡规则名称
checkin_type 打卡类型。字符串,目前有:上班打卡,下班打卡,外出打卡
exception_type 异常类型,字符串,包括:时间异常,地点异常,未打卡,wifi异常,非常用设备。如果有多个异常,以分号间隔
checkin_time 打卡时间。Unix时间戳
location_title 打卡地点title
location_detail 打卡地点详情
wifiname 打卡wifi名称
notes 打卡备注
wifimac 打卡的MAC地址/bssid
mediaids 打卡的附件media_id,可使用media/get获取附件
lat 位置打卡地点纬度,是实际纬度的1000000倍,与腾讯地图一致采用GCJ-02坐标系统标准
lng 位置打卡地点经度,是实际经度的1000000倍,与腾讯地图一致采用GCJ-02坐标系统标准
deviceid 打卡设备id
© 1998 - 2020 Tencent Inc. All Rights Reserved