关于通过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
相关产品推荐
相关产品推荐

