SuperAPI AI 工具集

cal-com

办公与效率

查看项目

更新于 10-16 07:25

技能介绍

用途:面向 Cal.com 开源日程预约平台,提供通过其 v2 REST API 进行日程与预约管理的操作指引,适用于面试安排、会议预订等场景。

主要能力:获取当前用户(/v2/me)、列出与查询事件类型(/v2/event-types)、查询可预约时段(/v2/slots/available)、创建预约(POST /v2/bookings)、列出与查询预约(GET /v2/bookings)、取消预约(DELETE /v2/bookings/<uid>/cancel)、改期预约(POST /v2/bookings/<uid>/reschedule)。

用法要点:调用时需在请求头携带 Authorization: Bearer $CALCOM_TOKEN 以及 cal-api-version: 2024-08-13,缺少版本头会失败。API Key 前缀为 cal_live_(生产)或 cal_test_(测试)。创建预约需提供 eventTypeId、ISO 8601 UTC 时间戳和 attendee 信息。自托管实例需将 api.cal.com 替换为自有域名。

限制与注意:速率限制为每分钟 120 次请求(API Key 认证),响应头含 X-RateLimit-Remaining;需要人工确认的事件类型,预约初始状态为 pending。

排障:可用 zero doctor check-connector --env-name CALCOM_TOKEN 或 zero doctor check-connector --url https://api.cal.com/v2/me --method GET 检查连接。官方文档见 https://cal.com/docs/api-reference/v2/bookings/create-a-booking。