如何使用Forge数据管理API上传BIM360工作共享Revit模型

报错根因 #

• 调用创建条目接口使用items:autodesk.bim360:C4RModel类型返回403白名单错误：该schema属于Revit云协同（C4R）的内部受限接口，不对普通第三方应用开放。无论使用2-legged鉴权还是携带x-user-id的3-legged鉴权，只要应用的client_id未加入Autodesk官方专属白名单，就会触发该权限报错，目前该白名单不对普通开发者开放申请。
• 上传item:autodesk.bim360:File类型的RVT后Revit端看不到文件：该类型属于通用文档存储类型，上传的RVT不会被识别为Revit云工作共享模型，仅会在Autodesk Docs网页端文件列表展示，不会同步到Revit客户端的云模型浏览目录。
• 调用Publish Model接口返回500错误：该发布接口仅对已生成合法C4R元数据的云工作共享模型生效，普通File类型上传的RVT缺少C4R模型必需的关联协同元数据，直接调用必然触发服务端内部错误，无法通过该路径完成普通文件到工作共享模型的转换。

实现方案 #

目前没有公开的无客户端API支持将通用接口上传的普通RVT文件直接转换为云工作共享模型，所有合法C4R模型的初始化必须依托Revit客户端完成。
可落地的操作流程如下：

• 第一步：通过数据管理通用上传接口，将本地RVT文件以items:autodesk.bim360:File类型上传到Autodesk Docs目标项目的对应文件夹
• 第二步：打开Revit客户端，登录具备项目对应权限的账号，从Docs文件路径中打开已上传的RVT文件
• 第三步：在Revit功能区执行「协作」-「启用工作共享」操作，选择将模型保存到云协同路径，Revit会自动完成普通RVT到C4R模型的转换、关联元数据挂载、初始版本发布全流程。转换完成后，模型就会正常展示在Revit的云模型列表中，支持多用户协同编辑。

补充说明 #

• 若需要实现批量初始化云工作共享模型的自动化流程，无法绕开Revit客户端环境。可基于Revit API编写本地插件，在Revit运行环境中批量完成文件打开、工作共享启用、云路径保存的操作，不存在其他纯API无客户端的实现路径。
• 不要尝试自行构造C4R类型的条目创建请求，无白名单的情况下所有这类请求都会被鉴权拦截；即使拿到临时白名单，手动构造的C4R条目缺少系统自动生成的协同关联元数据，后续使用中会出现版本同步、权限校验、协同操作的各类异常。

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