Autodesk Webhooks多回调过滤器配置失败问题求助

核心问题分析 #

你当前的错误源于过滤器格式不符合Webhooks API要求：Autodesk Webhooks不支持数组形式的多过滤器，也不能将数组转为字符串传递，必须把多个过滤条件合并为单个JSONPath表达式，用逻辑运算符连接。另外你还存在事件类型不一致的问题——要追踪处理完成状态，应该监听dm.version.modified事件，但请求URL里用的是dm.version.added，后者仅触发于版本首次创建，无法捕捉后续的处理状态更新。

正确的请求配置 #

修正后的请求URL #

POST https://developer.api.autodesk.com/webhooks/v1/systems/data/events/dm.version.modified/hooks

正确的请求体 #

{
    "callbackUrl": "https://my-app.com/webhooks/callback/version-modified",
    "scope": {
        "folder": "urn:adsk.wipprod:fs.folder:xxxxxxx"
    },
    "filter": "$[?(@.ext=='rvt' && @['custom-metadata']['storm:process-state']=='PROCESSING_COMPLETE')]"
}

关键细节说明 #

• 过滤器格式：用&&连接两个条件，合并为单个JSONPath字符串，这是Webhooks API唯一支持的多条件过滤方式。
• 特殊键名处理：storm:process-state包含冒号这类特殊字符，在JSONPath中必须用@['键名']的形式访问，不能直接写@.custom-metadata.storm:process-state，否则会解析失败。
• 事件类型匹配：dm.version.modified会在版本属性（包括自定义元数据的处理状态）更新时触发，正好匹配你追踪处理完成状态的需求；而dm.version.added仅在版本首次上传时触发，无法满足需求。

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