批量查询人员排班信息

说明

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

userids

string

必需

要查询的人员userid列表，多个userid用逗号分隔，一次最多可传入50个。

from_date_time

number

必需

起始日期，Unix时间戳，单位毫秒。

to_date_time

number

必需

结束日期，Unix时间戳，单位毫秒。开始时间和结束时间间隔不能超过7天。

示例

{
  "from_date_time": 1565591096000,
  "op_user_id": "user456",
  "userids": "user123,user456",
  "to_date_time": 1565591096000
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

result

array [object {10}]

查询结果。

可选

check_type

string

可选

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

plan_check_time

string

计划打卡时间。

可选

group_id

number

考勤组ID。

可选

userid

string

用户userid。

可选

approve_id

number

可选

排班绑定的审批单ID。

work_date

string

可选

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

number

排班ID。

可选

shift_version

number

班次版本。

可选

shift_id

number

可选

班次ID，休息班次为1。

is_rest

string

可选

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

success

boolean

成功标记。

可选

errcode

number

返回码。

可选

errmsg

string

返回信息。

可选

request_id

string

请求ID。

可选

示例

{
  "result": [
    {
      "check_type": "string",
      "plan_check_time": "string",
      "group_id": 0,
      "userid": "string",
      "approve_id": 0,
      "work_date": "string",
      "id": 0,
      "shift_version": 0,
      "shift_id": 0,
      "is_rest": "string"
    }
  ],
  "success": true,
  "errcode": 0,
  "errmsg": "string",
  "request_id": "string"
}

批量查询人员排班信息

说明#

权限#

请求参数

示例代码

返回响应

说明

权限