Autodesk Forge AssignPolicyToResources Webhook仅首次权限变更触发异常

问题描述 #

通过Autodesk Forge Webhooks API订阅了所有文件夹级事件（dm.folder.*），期望在文件夹重命名或权限变更时接收通知。目前重命名操作每次都能可靠触发Webhook，但AssignPolicyToResources事件仅在每个文件夹的首次权限变更（如添加/修改权限）时触发，后续对同一文件夹的权限变更均不会生成Webhook通知。

请求示例 #

POST https://developer.api.autodesk.com/webhooks/v1/systems/data/events/dm.folder.*/hooks
Authorization: Bearer <your-access-token>
Content-Type: application/json
x-ads-region: EMEA

{
  "callbackURL": "https://example.com/forge/webhook",
  "scope": {
    "folder": "YOUR_FOLDER_ID"
  }
}

复现步骤 #

• 在ACC中创建新文件夹。
• 为该文件夹订阅dm.folder.*事件（见上述请求）。
• 修改文件夹权限（如为用户A添加查看者权限）→ Webhook触发。
• 再次修改同一文件夹权限（如添加用户B或升级用户A为编辑者）→ 无Webhook触发。
• 重命名文件夹→ Webhook正常触发。

已做排查 #

• 验证回调端点始终返回HTTP 200。
• 尝试过单独订阅dm.folder.modified和通配符dm.folder.*。
• 重新创建过订阅和文件夹，问题依旧。

解决方案 #

1. 补充订阅Policy级事件 #

文件夹权限的后续变更实际是对关联的Policy资源的修改，而非文件夹本身的直接变更。因此需要额外订阅dm.policy.*事件，尤其是dm.policy.updated，来捕获后续的权限调整。

订阅请求示例（针对目标文件夹关联的Policy）：

POST https://developer.api.autodesk.com/webhooks/v1/systems/data/events/dm.policy.updated/hooks
Authorization: Bearer <your-access-token>
Content-Type: application/json
x-ads-region: EMEA

{
  "callbackURL": "https://example.com/forge/webhook",
  "scope": {
    "policy": "YOUR_POLICY_ID"
  }
}

可通过调用GET folders/:folder_id接口获取文件夹关联的policyId。

2. 明确事件触发逻辑 #

Forge Webhooks的触发逻辑如下：

• 首次为文件夹分配Policy时，会同时触发文件夹级事件（如dm.folder.modified）和dm.policy.created事件。
• 后续修改Policy权限时，仅会触发dm.policy.updated事件，不会再触发文件夹级事件。这就是后续权限变更无法通过dm.folder.*捕获的核心原因。

3. 回调端点的事件区分处理 #

在回调端点中，需针对不同事件类型做对应处理：

• 监听dm.folder.renamed或dm.folder.modified事件处理文件夹重命名操作。
• 监听dm.policy.created和dm.policy.updated事件处理权限变更，可通过事件 payload 中的relationships字段关联到对应的文件夹ID。

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