调用MS Graph API添加meetingRegistrant时出现Bad Request错误求助

问题概述 #

已完成MS Graph API认证并获取Teams Webinar的会议ID，但调用添加注册者接口时，在请求格式看似正确的情况下仅返回模糊的BadRequest错误；遗漏必填字段时能收到合理提示。请求详情如下：

请求信息 #

• 请求方法: POST
• 请求URL:

  https://graph.microsoft.com/beta/users/659fc6aa-615f-4cfc-8646-e8e4c7ad8c67/onlineMeetings/MSo2NTlmYzZhYS02MTVmLTRjZmMtODY0Ni1lOGU0YzdhZDhjNjcqMCoqMTk6bWVldGluZ19PR0prWTJGa1pqRXRaV1ZsTkMwME1XTXlMVGc0TldNdE9UQXhPVFppWVRjNE1UUmhAdGhyZWFkLnYy/registration/registrants
  

• 请求体:

  {
    "@odata.type": "#microsoft.graph.meetingRegistrant",
    "firstName": "firstname",
    "lastName": "lastname",
    "email": "email address removed for privacy reasons"
  }
  

• 请求头:

  Authorization: Bearer {TOKEN}
  Content-Type: application/json
  

错误响应 #

{
    "error": {
        "code": "BadRequest",
        "message": "Bad Request",
        "innerError": {
            "date": "2023-02-28T16:31:53",
            "request-id": "7767a8a2-770b-458d-9492-ab46a16f6c9b",
            "client-request-id": "7767a8a2-770b-458d-9492-ab46a16f6c9b"
        }
    }
}

排查建议 #

• 确认Webinar的注册配置：检查目标Webinar的注册设置，比如是否开启了手动审批、是否限制仅特定域邮箱注册，或者是否关闭了外部注册权限。这类配置可能导致符合格式的请求被拒绝。
• 验证邮箱有效性：确保请求中的邮箱是完整、合规的格式，无特殊字符或拼写错误；如果Webinar设置了域限制，需确认邮箱属于允许的域。
• 检查API权限：确认访问令牌包含足够的权限，beta版本中添加注册者通常需要OnlineMeetings.ReadWrite或OnlineMeetings.ReadWrite.All权限，且权限已被正确授予并同意。
• 确认会议类型与ID正确性：验证目标会议确实是Webinar类型（调用GET /onlineMeetings/{meetingId}查看isWebinar字段是否为true），普通Teams会议不支持注册功能，会导致此错误。
• 移除不必要的字段尝试：尝试删除请求体中的@odata.type字段，beta版本中该字段并非必填项，部分场景下多余的字段可能触发无明确提示的错误。
• 检查令牌有效性：确认访问令牌未过期，且受众（aud声明）为https://graph.microsoft.com，租户信息与目标Webinar所属租户一致。

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