获取打卡详情

POST

/attendance/listRecord

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

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

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

重要

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

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

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

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

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

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

权限

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

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

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://oapi.dingtalk.com/attendance/listRecord?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "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"
        }
    ]
}

修改于 2024-01-11 03:03:45

获取打卡结果

上传打卡记录

获取打卡详情

权限#

请求参数

返回响应

权限