Office365日历事件推送通知API验证失败问题求助

我之前配置Outlook推送订阅的时候也碰到过一模一样的问题，咱们一步步来定位原因：

1. 优先检查Notification URL的验证响应逻辑 #

微软创建推送订阅时，会立刻给你的NotificationURL发送一个GET请求，携带validationToken参数。你的服务必须满足两个要求才能通过验证：

• 响应状态码为200 OK
• 响应体必须原样返回这个validationToken（不能是JSON、HTML或其他内容）

举个Node.js的示例处理代码：

app.get('/notifications', (req, res) => {
  const validationToken = req.query.validationToken;
  // 处理验证请求
  if (validationToken) {
    res.status(200).send(validationToken);
    return;
  }
  // 处理后续的推送通知逻辑
  // ...
});

如果你的服务没有正确处理这个验证请求，就会直接触发ErrorInvalidParameter错误。

2. 确认Notification URL的可访问性 #

• 微软的服务器必须能公网直接访问你的URL：如果是本地开发环境，一定要用内网穿透工具生成公网可访问的HTTPS地址，不能用localhost或者内网IP。
• 检查你的服务是否有访问限制：比如防火墙拦截、需要登录验证（Cookie/Token）、CDN缓存等，这些都会导致微软的验证请求无法正常到达或获取响应。

3. 检查URL格式是否合规 #

• 必须使用HTTPS协议：微软不支持HTTP的NotificationURL，这是硬性要求。
• 确保URL没有特殊字符、编码错误，或者长度超出限制（虽然这种情况很少见）。

4. 顺带确认其他参数的合法性 #

虽然报错指向NotificationURL，但也可以快速核对：

• Resource：https://outlook.office.com/api/v2.0/me/events是合法的日历资源路径
• ChangeType：Created,Updated属于允许的变更类型（支持Created/Updated/Deleted的组合）

排查小技巧 #

可以用curl模拟微软的验证请求，测试你的服务响应是否符合要求：

curl "https://mywebsite.com/notifications?validationToken=test-token-123"

如果返回的不是test-token-123或者状态码不是200，那就是验证逻辑的问题。

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