查询排班打卡结果

说明

调用本接口查询排班的打卡结果，打卡结果包含打卡时间、迟到、早退、内勤及外勤等信息。
服务地址：https://oapi.dingtalk.com

权限

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

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

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

示例值:

6d1bxxxx

Body 参数application/json

op_user_id

string

必需

操作人userid。

schedule_ids

string

必需

排班ID，多个排班ID之间用逗号分割，可通过查询企业考勤排班详情接口获取。

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

result

array [object {16}]

查询结果。

可选

check_type

string

可选

考勤类型：Onduty：上班打卡OffDuty：下班打卡

gmt_modified

string

最后更新时间。

可选

plan_check_time

string

计划打卡时间。

可选

corp_id

string

可选

企业的CorpID。

base_check_time

string

可选

允许迟到早退等规则调整后的计划打卡时间。

group_id

number

考勤组ID。

可选

gmt_create

string

创建时间。

可选

user_id

string

可选

用户的userid。

work_date

string

可选

工作日，代表具体哪一天的排班。

number

打卡结果ID。

可选

location_result

string

可选

打卡位置结果：Normal：正常打卡NotSigned：未打卡Outside：外勤

is_legal

string

可选

打卡是否有异常：N：没有Y：有

time_result

string

可选

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

record_id

number

打卡记录。

可选

user_check_time

string

打卡时间。

可选

schedule_id

number

排班ID。

可选

success

boolean

成功标记。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

request_id

string

请求ID。

可选

示例

{
  "result": [
    {
      "check_type": "string",
      "gmt_modified": "string",
      "plan_check_time": "string",
      "corp_id": "string",
      "base_check_time": "string",
      "group_id": 0,
      "gmt_create": "string",
      "user_id": "string",
      "work_date": "string",
      "id": 0,
      "location_result": "string",
      "is_legal": "string",
      "time_result": "string",
      "record_id": 0,
      "user_check_time": "string",
      "schedule_id": 0
    }
  ],
  "success": true,
  "errcode": 0,
  "errmsg": "string",
  "request_id": "string"
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限