APS Webhooks：无发布时Revit云工作共享模型同步未触发adsk.c4r:model.sync

背景 #

使用Autodesk Platform Services (APS) Webhooks对接Autodesk Construction Cloud (ACC)，希望捕获Revit云工作共享模型仅同步（不发布）到中心文件的事件。根据官方文档，Revit云工作共享提供两个事件：

• adsk.c4r:model.sync：模型与中心文件同步时
• adsk.c4r:model.publish：模型进入发布队列或开始发布时

目标是仅接收同步操作的Webhook，排除发布触发的事件。

已执行操作 #

创建了针对model.sync事件的Webhook，配置如下：

{
  "system": "adsk.c4r",
  "event": "model.sync",
  "status": "active",
  "callbackUrl": "https://***/acc/test",
  "projectId": "***",
  "hubId": "***",
  "scope": {
    "folder": "urn:adsk.wipprod:fs.folder:***"
  },
  "hookAttribute": {
    "modelConnectionId": "***",
    "modelConnectionName": "***"
  }
}

Webhook创建成功且状态为active，但用户执行“与中心文件同步”操作时，从未收到推送。

验证结果 #

通过创建dm.version.added事件的Webhook验证了基础设施正常：

{
  "system": "data",
  "event": "dm.version.added",
  "status": "active",
  "callbackUrl": "https://***/acc/test",
  "projectId": "***",
  "hubId": "***",
  "scope": {
    "folder": "urn:adsk.wipprod:fs.folder:***"
  }
}

发布新版本时该Webhook正常触发，确认：
✅ Webhook基础设施正常
✅ 文件夹范围正确
✅ 回调端点可访问
❌ adsk.c4r:model.sync在仅同步操作时从未触发

疑问解答 #

1. 是否可通过APS Webhooks检测无发布的Revit云工作共享模型同步事件？ #

不能，目前APS没有直接支持该场景的Webhook事件。

2. adsk.c4r:model.sync是否仅在特定条件下触发？ #

是的，该事件仅在同步操作与发布流程绑定时触发：

• 用户执行“同步并发布”操作
• 发布过程中系统自动完成的同步环节
  单纯的“与中心文件同步”（无发布）不会触发此事件。

3. 是否需要发布操作才会触发该事件？ #

是的，adsk.c4r:model.sync的触发逻辑依赖发布动作，独立的同步操作不会触发它。

4. 是否有其他方式检测仅同步的Revit云工作共享模型变更？ #

可以通过以下间接方式实现：

• API轮询：定期调用APS的Data Management API获取模型连接的详情，检查lastSyncTime属性的时间戳变化，以此判断是否发生了同步操作。
• Revit本地插件：开发Revit插件，通过Revit API捕获本地同步事件，再将事件上报到你的服务。但这种方式需要用户安装插件，适用性有限。

内容的提问来源于stack exchange，提问作者Antonio Blanco Modelical