获取打卡详情

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，获取企业内员工的实际打卡详情。

例如，企业给一个员工设定的排班是上午9点和下午6点各打一次卡，但是员工在这期间打了多次，本接口会把所有的打卡记录都返回。

重要

本接口不支持查询半年以前的数据。

如果只需要获取打卡结果数据，不需要详情数据，可使用获取打卡结果接口。

企业内部应用，调用获取打卡结果。

第三方企业应用，调用获取打卡结果。

考勤信息同步可能会出现延迟，可稍后再试。

如果当天用户有排班，但是没有打卡操作，本接口返回的信息为空。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	查询企业考勤数据权限	调试
第三方企业应用	是	查询企业考勤数据权限	调试
第三方个人应用	否	—	—

curl --location --request POST 'https://oapi.dingtalk.com/attendance/listRecord?access_token=6d1bxxxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "checkDateFrom": "2020-09-07 00:00:00", "userIds": [ "user456", "user123" ], "isI18n": "false", "checkDateTo": "2020-09-08 00:00:00" }'

{ "errcode": 0, "errmsg": "ok", "recordresult": [ { "gmtModified": 1599454972000, "baseCheckTime": 1599442200000, "groupId": 685935028, "timeResult": "Normal", "deviceId": "67da0fxxxx", "approveId": 2376620852, "userAccuracy": 65, "classId": 677995086, "workDate": 1599408000000, "bizId": "E171DCCExxxx", "planId": 144872188720, "id": 43047156750, "checkType": "OnDuty", "planCheckTime": 1599442200000, "corpId": "dinge8axxxx5384", "locationResult": "Outside", "userLongitude": 120.017139, "isLegal": "N", "procInstId": "59f77e82-xxxx", "gmtCreate": 1599441505000, "userId": "manager4220", "outsideRemark": "拜访客户", "userAddress": "浙江省杭州市", "userLatitude": 30.285413, "sourceType": "USER", "userCheckTime": 1599441505000, "locationMethod": "MAP" }, { "gmtModified": 1599450909000, "deviceId": "67da0fxxxx", "userAccuracy": 65, "workDate": 1599408000000, "bizId": "E171DCCExxxx", "id": 43055377426, "invalidRecordType": "Other", "corpId": "dinge8axxxx5384", "userLongitude": 120.017019, "gmtCreate": 1599450909000, "invalidRecordMsg": "需要二次确认", "userId": "manager4220", "userAddress": "浙江省杭州市", "userLatitude": 30.285622, "sourceType": "USER", "userCheckTime": 1599450909000, "locationMethod": "MAP" } ] }

请求参数

Query 参数

access_token

必需

调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。

示例值:

6d1bxxxx

Body 参数application/json

userIds

object

必需

企业内的员工ID列表，最多不能超过50个。

checkDateFrom

string

必需

查询考勤打卡记录的起始工作日。格式为：yyyy-MM-dd hh:mm:ss。

checkDateTo

string

必需

查询考勤打卡记录的结束工作日。格式为：yyyy-MM-dd hh:mm:ss。起始与结束工作日最多相隔7天。

isI18n

boolean

可选

是否为海外企业使用：true：海外平台使用false（默认）：国内平台使用

示例

返回响应

🟢200成功

application/json

Body

recordresult

array [object {38}]

打卡详情。

可选

userAccuracy

string

用户打卡定位精度。

可选

classId

number

班次ID。

可选

userLatitude

string

用户打卡纬度。

可选

userLongitude

string

用户打卡经度。

可选

userAddress

string

用户打卡地址

可选

deviceId

string

打卡设备ID。

可选

locationMethod

string

定位方法。

可选

isLegal

string

可选

是否合法。Y：合法当timeResult和locationResult都为Normal时，为该值。N：不合法

userCheckTime

string

实际打卡时间。

可选

procInstId

string

可选

关联的审批实例id，当该字段非空时，表示打卡记录与请假、加班等审批有关，可以和获取审批实例详情配合使用。

baseCheckTime

string

可选

计算迟到和早退，基准时间；也可作为排班打卡时间。

approveId

number

可选

关联的审批ID，当该字段非空时，表示打卡记录与请假、加班等审批有关。

timeResult

string

可选

打卡结果：Normal：正常Early：早退Late：迟到SeriousLate：严重迟到Absenteeism：旷工迟到NotSigned：未打卡

locationResult

string

可选

位置结果：Normal：范围内Outside：范围外NotSigned：未打卡

checkType

string

可选

考勤类型：OnDuty：上班OffDuty：下班

sourceType

string

可选

数据来源：ATM：考勤机打卡（指纹/人脸打卡）BEACON：IBeaconDING_ATM：钉钉考勤机（考勤机蓝牙打卡）USER：用户打卡BOSS：老板改签APPROVE：审批系统SYSTEM：考勤系统AUTO_CHECK：自动打卡

userId

string

可选

打卡人的userid。

workDate

string

工作日。

可选

corpId

string

企业ID。

可选

planId

number

排班ID。

可选

groupId

number

考勤组ID。

可选

number

考勤ID。

可选

invalidRecordType

string

可选

异常信息类型：Security：安全相关原因Other：其他原因

userSsid

string

可选

用户打卡wifi SSID。

userMacAddr

string

可选

用户打卡wifi Mac地址。

planCheckTime

string

排班打卡时间。

可选

baseAddress

string

基准地址。

可选

baseLongitude

string

基准经度。

可选

baseLatitude

string

基准纬度。

可选

baseAccuracy

string

基准定位精度。

可选

baseSsid

string

可选

基准wifi ssid。

baseMacAddr

string

基准Mac地址。

可选

gmtCreate

string

打卡记录创建时间。

可选

invalidRecordMsg

string

可选

对应的invalidRecordType异常信息的具体描述。

string

打卡记录修改时间。

可选

outsideRemark

string

打卡备注。

可选

deviceSN

string

打卡设备序列号。

可选

bizId

string

关联的业务ID。

可选

errmsg

string

返回码描述。

可选

errcode

number

返回码。

可选

权限#

请求参数

返回响应

权限