You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

关于通过Autodesk Platform Services Webhooks API获取Revit同步发起用户的疑问

问题:如何通过API获取ACC上Revit云模型同步的发起用户?

我正在为公司开发一款工具,用来跟踪用户在ACC上同步Revit云共享模型的情况。目前webhook的model.sync事件接收正常,但回调的payload里没有发起同步的用户信息,只显示了webhook创建者和更新的文件。我尝试调用API查询最后编辑者,得到的却是最近发布模型的用户,不是同步操作的发起者。另外,payload里返回的episodeGuid在官方文档里找不到相关说明。想请教下:是不是我哪里操作遗漏了,还是目前根本无法通过API获取Revit同步发起用户?

收到的webhook payload示例:

{
  "version": "1.0",
  "resourceUrn": "urn:adsk.wipprod:dm.lineage:4qsCZu1nRNWvGThBdoHlvw",
  "hook": {
    "system": "adsk.c4r",
    "event": "model.sync",
    "hookId": "ce4cc990-31c4-11e8-94f2-73ce66fa9735",
    "tenant": "urn:adsk.wipprod:fs.folder:co.s424tpjyS_yYBs5ozch94g",
    "callbackUrl": "http://bf067e05.ngrok.io/callback",
    "createdBy": "************",
    "createdDate": "2017-09-22T02:38:32.341+0000",
    "creatorType": "Application",
    "hookAttribute": {
      "myfoo": 34,
      "projectId": "someURN",
      "myobject": {
        "nested": true
      }
    },
    "scope": {
      "folder": "urn:adsk.wipprod:fs.folder:co.s424tpjyS_yYBs5ozch94g"
    },
    "urn": "urn:adsk.webhooks:events.hook:1fcd3e30-9f3f-11e7-951f-0fd5337ed5ce",
    "status": "active",
    "__self__": "/systems/adsk.c4r/events/model.sync/hooks/ce4cc990-31c4-11e8-94f2-73ce66fa9735"
  },
  "payload": {
    "state" : "SYNC_COMPLETE",
    "projectId" : "b.65ddd035-a4a1-4e15-9db8-1b2b4a410bcf",
    "parentFolder" : "urn:adsk.wipprod:fs.folder:co.s424tpjyS_yYBs5ozch94g",
    "modelGuid" : "0f29fb84-ea94-46a9-9488-ca9f88d58461",
    "projectGuid" : "9a1ea050-ab00-440a-9b64-520b38eb1dd2",
    "modelVersion" : 15,
    "episodeGuid" : "617e8d76-1dbc-40be-86c7-c1b8643495af"
  }
}
解答

目前ACC的model.sync webhook事件payload确实不直接提供同步发起用户的信息,这是当前API设计的限制。你查询到的“最后编辑者”字段,本身对应模型发布操作的用户,和同步是两个独立行为,所以无法通过该字段获取同步发起者。

关于episodeGuid,它是ACC内部用于追踪模型版本迭代周期的标识,目前官方文档未公开其具体用途,也没有配套API可通过它查询关联用户信息。

如果需要获取同步发起用户,目前有两个可行替代方案:

  • 使用ACC活动日志API:查询项目活动日志,筛选对应模型的“同步完成”事件,日志记录会包含发起同步的用户ID和名称。注意需要对应权限,且要根据modelGuid和事件时间范围精准匹配。
  • 结合Revit本地事件追踪:若工具能和用户本地Revit客户端集成,可通过Revit API捕获本地同步事件,再将用户信息上报到你的系统。但该方式仅适用于能管控用户Revit客户端的场景。

另外,也可以通过Autodesk开发者支持渠道提交功能请求,建议在model.sync webhook payload中增加同步发起用户字段,后续API更新可能会支持该需求。


内容的提问来源于stack exchange,提问作者Jonathan Malott

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.05 07:27:39