feishu-calendar

Feishu Calendar API for creating, querying, updating, and managing schedules and calendar permissions. 通过 Calendar API 管理日程。 Base URL : 从 feishu_skills 根目录执行共享脚本： 请求头统一使用 Authorization: Bearer ${TOKEN} 。 如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求： 环境变量 : 本地缓存 : ./.feishu_token_cache.json （未过期直接复用，默认提前 5 分钟刷新） 创建日程 : attendees type : user / chat / resource (会议室) ACL role : none / free_busy_reader / reader / writer / owner 占用会议室的关键：在 attendees 中添加 type: "resource" 的参与人， attendee_id 填会议室的 room_id 。 完整流程 ： ⚠️ 若会议室在该时段已被占用，创建请求会返回冲突错误，请先查询忙闲再预订。 时间格式 : 分页参数 : user_id_type : 用户 ID 类型 获取日历列表 : 创建日程 : - Full event lifecycle management: create, retrieve, update, delete, and search events with attendee support (users, chats, meeting rooms) - Calendar administration including creation, sharing, ACL-based permissions (five role levels from free_busy_reader to owner), and subscription management - Meeting room operations: list rooms, fetch details, and query availability windows - Pagination support for large datasets and flexible user ID types (open_id, user_id, union_id) - FEISHU_APP_ID - FEISHU_APP_SECRET - timestamp : 秒级时间戳（如 "1770508800" ） - date : 日期字符串（如 "2026-03-07" ） - page_size : 每页数量（默认 50，最大 500） - page_token : 分页标记（从上次响应获取） - open_id （默认） - user_id - union_id - 时间用秒级时间戳 - attendees 指定类型 （user/chat/resource） - 分页查询 ：大量数据用 page_token 分页 - 主日历 ：用户个人日历用 primary 作为 calendar_id