查询排班打卡结果

POST

/topapi/attendance/schedule/result/listbyids

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

调用本接口，根据排班ID查询对应的打卡结果。

调用本接口，可查询排班打卡结果，获取考勤类型、计划打卡时间、最后更新时间等信息。

权限

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

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

请求参数

Query 参数

Body 参数application/json

示例

{
        "op_user_id":"user456",
        "schedule_ids":"161xxxx530,160xxxxx12"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/topapi/attendance/schedule/result/listbyids?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
        "op_user_id":"user456",
        "schedule_ids":"161xxxx530,160xxxxx12"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg":"ok",
    "result": [
        {
            "base_check_time": "2020-11-11 19:03:00",
            "check_type": "OnDuty",
            "corp_id": "dingxxxxx1c1",
            "gmt_create": "2020-11-11 19:03:21",
            "gmt_modified": "2020-11-11 19:03:21",
            "group_id": 67xxxx4,
            "id": 11xxxx19,
            "is_legal": "Y",
            "location_result": "Normal",
            "plan_check_time": "2020-11-11 19:03:20",
            "record_id": 48xxxx644,
            "schedule_id": 16xxxx812,
            "time_result": "Normal",
            "user_check_time": "2020-11-11 19:03:20",
            "user_id": "user456",
            "work_date": "2020-11-11 00:00:00"
        }
    ],
    "success": true,
    "request_id": "6k9c3cvix353"
}

修改于 2025-09-08 06:28:05

排班制考勤组排班

查询企业考勤排班详情

查询排班打卡结果

权限#

请求参数

请求示例代码

返回响应

权限