查询假期消费记录

说明

调用本接口根据企业或员工分页获取假期消费记录信息，每次返回50条数据。
服务地址：https://oapi.dingtalk.com

权限

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

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

请求参数

Query 参数

access_token

string

必需

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

示例值:

6d1bxxxx

Body 参数application/json

op_userid

string

必需

当前企业内拥有“OA审批”应用权限的管理员的userid。

leave_code

string

必需

假期类型唯一标识，可以通过调用假期类型查询接口获取。

userids

string

必需

待查询员工ID列表。

offset

number

必需

分页页码，从0开始非负整数。

size

number

必需

分页大小，最大50。

示例

{
    "offset": "0",
    "size": "10",
    "userids": "user1,user2",
    "leave_code": "f84a2dxxxx",
    "op_userid": "user01"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

result

object

返回结果。

可选

has_more

boolean

是否存在更多记录。

可选

leave_records

array [object {13}]

假期消费记录列表。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

success

boolean

是否正确访问。

可选

request_id

string

请求ID。

可选

示例

{
    "result": {
        "has_more": true,
        "leave_records": [
            {
                "userid": "string",
                "leave_code": "string",
                "record_id": "string",
                "quota_id": "string",
                "start_time": 0,
                "end_time": 0,
                "leave_view_unit": "string",
                "cal_type": "string",
                "leave_reason": "string",
                "leave_status": "string",
                "leave_record_type": "string",
                "record_num_per_day": 0,
                "record_num_per_hour": 0
            }
        ]
    },
    "errcode": 0,
    "errmsg": "string",
    "success": true,
    "request_id": "string"
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限