删除请假日程
调用该接口删除一个指定的请假日程。请假日程删除后，用户个人签名页的请假信息也会消失。
Tip: - 使用应用身份调用该接口，需要确保应用开启了机器人能力。
- 当前应用身份只能删除自己创建的请假日程。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/calendar/v4/timeoff_events/:timeoff_event_id |
| HTTP Method | DELETE |
| 接口频率限制 | 1000 次/分钟、50 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | calendar:time_off:delete 删除请假日程 calendar:timeoff 创建或删除请假日程 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
timeoff_event_id | string | 请假日程 ID，在创建请假日程时从返回结果中获取。 示例值："timeoff:XXXXXX-XXXX-0917-1623-aa493d591a39" |
响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码，非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {}
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 190002 | invalid parameters in request | 无效的请求参数。排查建议如下： - 确认请求参数的字段名称、传参类型正确。 - 确认已经申请了相应资源的权限。 - 确认相应资源未被删除。 |
| 500 | 190003 | internal service error | 内部服务错误，请咨询技术支持。 |
| 429 | 190004 | method rate limited | 方法频率限制。建议稍后再试，并适当减小请求 QPS。 |
| 429 | 190005 | app rate limited | 应用频率限制。建议稍后再试，并适当减小请求 QPS。 |
| 403 | 190006 | wrong unit for app tenant | 请求错误，检查应用 App ID 和 App Secret 是否正确。如仍无法解决请咨询技术支持。 |
| 404 | 190007 | app bot_id not found | 应用的 bot_id 没有找到。你需要确保应用开启了机器人能力。如仍未解决请咨询技术支持。 |
| 429 | 190010 | current operation rate limited | 当前操作被限流，原因一般为公用资源并发抢占失败。你可以适当降低当前操作频率，然后重试。 |
| 403 | 195000 | no permission to delete timeoff event | 无权删除请假日程。你需要检查请假日程是否是当前应用创建的，并修改为正确的请假日程 ID。 |
| 404 | 195100 | user is dismiss or not exist in the tenant | 当前身份或指定用户已经离职，或者不在该租户内。请检查并改为正确的身份来调用接口。 |
更多错误码信息，参见通用错误码。