查询排班概要信息

说明

调用本接口查询用户在某个时间段内的排班概要信息。
服务地址：https://oapi.dingtalk.com

权限

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

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

请求参数

Query 参数

access_token

string

必需

调用服务端API授权凭证，可通过获取企业内部应用的access_token接口获取。

示例值:

57cf92xxx

Body 参数application/json

op_user_id

string

必需

操作者的userid。

userids

string

必需

需要查询的用户userid列表，多个userid之间使用逗号分隔，且一次查询最多不能超过20。

from_date_time

number

必需

开始日期的Unix时间戳，单位毫秒。时间跨度不能超过7天。

to_date_time

number

必需

结束日期的Unix时间戳，单位毫秒。时间跨度不能超过7天。

示例

{
  "from_date_time": 1564985177000,
  "op_user_id": "manager123",
  "userids": "user123,user456",
  "to_date_time": 1564985177000
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

result

array [object {7}]

返回结果列表。

可选

work_date

string

工作日。

可选

shift_names

array[string]

班次名称。

可选

userid

string

可选

用户的userid。

shift_versions

array[number]

班次版本ID。

可选

shift_ids

array[number]

班次ID。

可选

group_id

number

考勤组ID。

可选

corp_id

string

可选

企业的CorpId。

success

boolean

可选

调用是否成功的标记。

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

request_id

string

请求ID。

可选

示例

{
  "result": [
    {
      "work_date": "string",
      "shift_names": [
        "string"
      ],
      "userid": "string",
      "shift_versions": [
        0
      ],
      "shift_ids": [
        0
      ],
      "group_id": 0,
      "corp_id": "string"
    }
  ],
  "success": true,
  "errcode": 0,
  "errmsg": "string",
  "request_id": "string"
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限