使用Forge API下载带链接的Revit模型无法获取关联文件如何解决

问题原因 #

你当前使用的GET buckets/:bucketKey/objects/:objectName是Forge OSS服务的原生单对象下载接口，设计上仅会返回你指定的单个根Revit文件，不会自动打包关联的链接参考文件。你此前能通过该接口拿到包含链接文件的压缩包，属于早期Forge针对BIM 360托管文件的临时适配行为，后续官方修正了不符合接口定位的逻辑，才出现了你现在碰到的情况，不属于版本回归BUG。

实现打包下载所有链接文件的方案 #

要获取和BIM 360网页端下载一致的、包含所有关联链接文件的压缩包，请按以下步骤操作：

• 先通过Forge Data Management API查询到目标Revit文件对应的项目ID、文件版本ID，不要直接使用OSS层的bucketKey和objectName参数
• 调用文档导出接口POST projects/:project_id/versions/:version_id/export，请求体中必须添加includeExternalFiles: true参数，该参数会触发服务端将所有关联的链接文档和根文件一同打包
• 轮询导出作业的执行状态，待作业处理完成后即可拿到ZIP压缩包的下载地址，下载后的压缩包内容和BIM 360网页端直接下载的内容完全一致

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