调用Microsoft Graph API获取MS Bookings员工可用性时遇UnknownError

问题复现 #

调用Microsoft Graph API的Bookings员工可用性查询端点时，持续返回500 UnknownError，错误响应如下：

{
    "error": {
        "code": "UnknownError",
        "message": "",
        "innerError": {
            "date": "2022-07-25T08:21:46",
            "request-id": "aa302590-9a6e-47a4-a5ac-51a12ef5e72e",
            "client-request-id": "aa302590-9a6e-47a4-a5ac-51a12ef5e72e"
        }
    }
}

已按官方规范操作，解码访问令牌确认权限无误，且在Graph Explorer中复现相同错误。

排查建议 #

• 校验请求参数合法性：
  确认请求体中staffIds、startDateTime、endDateTime、timeZone参数完全符合要求：
  • staffIds必须是关联目标Booking Business的有效员工ID，不能包含不存在的ID
  • 日期时间严格遵循ISO 8601格式（例：2022-08-01T09:00:00）
  • timeZone使用标准时区名称（例：Pacific Standard Time），避免缩写或自定义值
• 检查Bookings业务配置：
  确认目标Booking Business及员工配置无异常：
  • 员工账户已关联到该Booking Business，且状态为启用
  • 员工的工作时间、休假设置无冲突或格式错误
• 缩小请求范围测试：
  • 先查询单个员工的可用性，排除多ID冲突问题
  • 缩短查询时间范围（从1天开始测试），排查是否因范围过大触发服务端异常
• 提交官方支持工单：
  因错误为UnknownError且包含有效request-id，直接通过Microsoft 365管理中心提交工单，提供以下信息：
  • 完整的请求ID、错误发生日期
  • 请求的端点URL和请求体内容
  • 访问令牌的权限声明（脱敏敏感信息）
  • Graph Explorer中复现错误的截图

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