calcom-api

Cal.diy API v2 技能使 AI 代理能够以程序化方式与自托管的 Cal.diy 排程基础设施进行互动。该工具集专为希望将强大的排程功能嵌入自定义应用程序、内部工具或 AI 驱动工作流的开发人员与自动化工程师而设计。通过利用此 API，用户可以从手动日历协调转换为完全自动化的预约系统，并能处理复杂的可用性规则、管理多种活动类型以及验证实时日历状态。

主要功能包括：

• 全面的预约生命周期管理，包含预约创建、重新安排、取消以及预约详情的获取。
• 动态时段查询，可根据特定活动类型、用户限制和日期范围识别可用时间窗口。
• 对活动类型配置的精细控制，使代理能够定义会议持续时间、地点与预约规则。
• 通过 Webhooks 提供实时通知支持，允许系统对预约创建、确认或取消等事件作出即时反应。
• 通过 Client ID 与 Secret 认证标头，全面支持多租户或平台整合。

实用说明与限制：

• 所有 API 请求皆需使用 CAL_API_KEY 环境变量进行 Bearer Token 验证。对于平台场景，请确保正确注入 x-cal-client-id 与 x-cal-secret-key 标头。
• 请务必将所有时间戳输入转换为 ISO 8601 格式，以确保与底层系统的兼容性。
• 在创建预约前，代理应始终执行 GET /v2/slots 请求，以验证所选时间窗口是否仍然可用。
• 请妥善保存并追踪 API 返回的预约 UID；这些识别码对于执行后续的生命周期操作（如更新或取消）至关重要。
• 实施稳健的错误处理机制，并在使用批处理操作或高频排程任务时，采取指数退避（Exponential Backoff）策略以维护系统稳定性。
• 请注意，此技能适用于开源的 Cal.diy 实例，该实例专为自托管环境设计。请确保目标基础设施已按照平台要求正确配置 Node.js 与 PostgreSQL。