资源介绍

资源定义

请假是一种特殊的日程，在用户请假后，除了在日历内显示该日程外，还会在个人签名上展示请假信息。开发者可以调用这个接口，将用户的请假状态同步到日历和个人签名中。

字段说明

名称	类型	描述
timeoff_event_id	string	请假日程ID。参见请假日程ID说明示例值："timeoff:XXXXXX-XXXX-0917-1623-aa493d591a39-XXXXXX"
user_id	string	用户id，参见用户相关的 ID 概念示例值："ou_XXXXXXXXXX"
timezone	string	时区字符串示例值："Asia/Shanghai"
start_time	string	休假开始时间：有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；时间戳格式是按小时休假日程，日期格式是全天休假日程；start_time与end_time格式需保持一致，否则无效。示例值："2021-01-01"
end_time	string	休假结束时间：有时间戳(1609430400)和日期(2021-01-01)两种格式，其它格式无效；时间戳格式是按小时休假日程，日期格式是全天休假日程；start_time与end_time格式需保持一致，否则无效。示例值："2021-01-01"
title	string	自定义请假日程标题，没有设置则为默认日程标题
description	string	自定义请假日程描述，没有设置则为默认日程描述

数据示例

{
    "timeoff_event_id": "timeoff:XXXXXX-XXXX-0917-1623-aa493d591a39-XXXXXX",
    "user_id": "ou_XXXXXXXXXX",
    "timezone": "Asia/Shanghai",
    "start_time": "2021-01-01",
    "end_time": "2021-01-01",
    "title": "请假中(全天) / 1-Day Time Off",
    "description": "若删除此日程，飞书中相应的“请假”标签将自动消失，而请假系统中的休假申请不会被撤销。"
}

请假日程 ID 说明

什么是 timeoff_event_id

timeoff_event_id是一次请假申请的唯一标识ID；定义了唯一的请假信息。
timeoff_event_id的一般格式是timeoff:XXXXXX-XXXX-0917-1623-aa493d591a39-XXXXXX。

如何获取 timeoff_event_id

timeoff_event_id可以通过创建请假日程获取。

资源定义#

字段说明#

数据示例#

请假日程 ID 说明#