查询成员排班信息

说明

调用本接口查询某人在某工作日的排班信息。
服务地址：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。

user_id

string

必需

要查询的人员userid列表。

date_time

number

必需

查询的时间，Unix时间戳，单位毫秒。

示例

{
  "op_user_id": "user123",
  "date_time": 1599580799000,
  "user_id": "user456"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

result

array [object {24}]

查询结果。

可选

check_type

string

可选

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

approve_type

string

审批类型。

可选

gmt_modified

string

最后更新时间。

可选

plan_check_time

string

计划打卡时间。

可选

corp_id

string

可选

企业的Corpid，可在开发者后台获取。

check_date_time

string

打卡时间。

可选

base_check_time

string

可选

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

group_id

number

考勤组ID。

可选

class_name

string

班次名称。

可选

gmt_create

string

创建时间。

可选

user_id

string

可选

用户的userid。

approve_biz_type

number

可选

排班绑定的假勤审批类型：1：加班2：出差3：请假

approve_id

number

可选

排班绑定的审批单ID。

class_setting_id

number

可选

排班关联的班次设置ID，如果没返回则表示使用的全局配置。

approve_tag_name

string

可选

排班绑定的假勤审批单名称。

features

string

扩展字段。

可选

class_id

number

班次ID。

可选

check_status

string

可选

打卡状态：Init：未打Checked：已打卡Timeout：缺卡

work_date

string

可选

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

check_end_time

string

结束打卡时间。

可选

is_rest

string

可选

是否休息：Y：当天排休N：不休息

check_begin_time

string

开始打卡时间。

可选

real_plan_time

string

可选

开启弹性工时卡点调整后用户应打卡时间。

number

排班ID。

可选

success

boolean

成功标记。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

request_id

string

请求ID。

可选

示例

{
  "result": [
    {
      "check_type": "string",
      "approve_type": "string",
      "gmt_modified": "string",
      "plan_check_time": "string",
      "corp_id": "string",
      "check_date_time": "string",
      "base_check_time": "string",
      "group_id": 0,
      "class_name": "string",
      "gmt_create": "string",
      "user_id": "string",
      "approve_biz_type": 0,
      "approve_id": 0,
      "class_setting_id": 0,
      "approve_tag_name": "string",
      "features": "string",
      "class_id": 0,
      "check_status": "string",
      "work_date": "string",
      "check_end_time": "string",
      "is_rest": "string",
      "check_begin_time": "string",
      "real_plan_time": "string",
      "id": 0
    }
  ],
  "success": true,
  "errcode": 0,
  "errmsg": "string",
  "request_id": "string"
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限