SuperAPI AI 工具集

feishu-calendar

办公与效率

查看项目

更新于 10-15 16:47

技能介绍

用途:通过飞书 Calendar API(Base URL: https://open.feishu.cn/open-apis/calendar/v4)管理日程与日历。

主要能力:日程的创建、获取、更新、删除、搜索与列表查询;参与人(user/chat/resource)的获取、添加、删除及群成员查询;日历的列表、主日历、创建、获取、更新、删除与搜索;ACL 权限管理与日历/日程订阅;会议室列表、详情、忙闲查询,并可在创建日程时通过 attendees 中 type 为 resource、attendee_id 填 room_id 来占用会议室。

认证与用法:从 feishu_skills 根目录执行 TOKEN="$(./scripts/get_feishu_token.sh)" 获取令牌,请求头使用 Authorization: Bearer ${TOKEN}。若返回 token 无效、过期或 401,用 ./scripts/get_feishu_token.sh --force-refresh 强制刷新后仅重试一次。需配置环境变量 FEISHU_APP_ID、FEISHU_APP_SECRET,本地缓存 ./.feishu_token_cache.json 未过期直接复用,默认提前 5 分钟刷新。

参数与限制:时间可用秒级 timestamp 或 date 字符串;分页用 page_size(默认 50,最大 500)与 page_token;user_id_type 支持 open_id(默认)、user_id、union_id;ACL role 为 none/free_busy_reader/reader/writer/owner。会议室被占用时创建请求返回冲突错误,需先查询忙闲再预订。

适用场景:日程安排、会议邀请、共享日历与权限管理、会议室预订等。其他未在资料中说明的细节暂未提供。