用途:通过 Calendly 公开 API 查询账户与日程数据,并订阅预约或取消事件通知。适用于用户提到 Calendly、calendly.com、安排会议、预约链接、事件类型或面试等场景。
主要能力:获取当前认证用户及其组织 URI;列出事件类型;列出即将到来或已取消的已排期活动;获取单个活动详情;列出某活动的受邀人;创建、列出和删除 Webhook 订阅。
使用方式:请求需携带 Authorization: Bearer $CALENDLY_TOKEN。先调用 GET https://api.calendly.com/users/me 获取用户 URI 和组织 URI,再用于后续查询。事件类型示例:curl -s "https://api.calendly.com/event_types?user=<user-uri>" --header "Authorization: Bearer $CALENDLY_TOKEN"。已排期活动示例:curl -s "https://api.calendly.com/scheduled_events?user=<user-uri>&status=active&count=20" --header "Authorization: Bearer $CALENDLY_TOKEN"。受邀人示例:curl -s "https://api.calendly.com/scheduled_events/<event-uuid>/invitees" --header "Authorization: Bearer $CALENDLY_TOKEN"。Webhook 创建使用 POST https://api.calendly.com/webhook_subscriptions,请求体包含 url、events、organization、scope。
排障:请求失败时可运行 zero doctor check-connector --env-name CALENDLY_TOKEN 或 zero doctor check-connector --url https://api.calendly.com/users/me --method GET。
限制:Calendly 使用完整 URI 作为标识符,过滤参数须用完整 URI;API 为只读,不能通过 API 创建预约或强制安排会议,需引导用户使用事件类型中的 scheduling_url 自助预约;Webhook 订阅仅 Standard 及以上付费计划可用;个人事件用 user scope,团队数据用 organization scope;分页使用 pagination.next_page_token 中的 page_token;活动状态 active 表示即将到来或已确认,canceled 表示已取消。