如何正确设置Calendly获取日程事件列表的organization/user参数？

问题核心原因 #

调用GET https://api.calendly.com/users/me返回的current_organization是完整的API资源URI（例如https://api.calendly.com/organizations/2c93f482-emd0-0eh4-a0rd-c77429ec73e8），而获取日程事件的接口要求传入的organization参数是组织的UUID，不是完整URI，这就是导致“无效组织”错误的直接原因。

正确参数填写方式 #

方式1：使用organization参数

1. 从users/me接口的响应中提取current_organization字段值，截取URI最后一段的UUID部分。
   示例：
   • 原始current_organization值：https://api.calendly.com/organizations/2c93f482-emd0-0eh4-a0rd-c77429ec73e8
   • 截取后的UUID：2c93f482-emd0-0eh4-a0rd-c77429ec73e8
2. 将UUID作为organization参数传入接口：

   GET https://api.calendly.com/scheduled_events?organization=2c93f482-emd0-0eh4-a0rd-c77429ec73e8
   

方式2：使用user参数（精准获取单个用户的事件）

如果只需获取当前用户的日程事件，也可以用user参数替代：

1. 从users/me接口的响应中提取uri字段值，截取最后一段的用户UUID。
   示例：
   • 原始uri值：https://api.calendly.com/users/abc123-def4-ghi5-jkl6-mno789pqrst0
   • 截取后的UUID：abc123-def4-ghi5-jkl6-mno789pqrst0
2. 将用户UUID作为user参数传入接口：

   GET https://api.calendly.com/scheduled_events?user=abc123-def4-ghi5-jkl6-mno789pqrst0
   

官方文档参考（翻译） #

根据Calendly官方文档，获取日程事件列表的接口支持两种过滤逻辑：

• 通过organization参数：传入组织UUID，返回该组织下所有用户的所有日程事件
• 通过user参数：传入用户UUID，返回该用户的所有日程事件

内容的提问来源于stack exchange，提问作者Bhavesh Kadiya