关于通过API获取BIM 360/ACC中Revit模型版本的技术咨询

1. Manifest方法获取Revit版本的正确位置 #

你提到的Manifest API响应结构不符，核心原因是需要先触发模型转换（Translate API），未转换的文件Manifest不会包含Revit版本信息。转换完成后，在Manifest响应的derivatives数组中，找到type为"Autodesk.Revit"的节点，其properties字段下会包含revitVersion属性，示例结构如下：

{
  "derivatives": [
    {
      "type": "Autodesk.Revit",
      "properties": {
        "revitVersion": "2023"
      },
      "children": [...]
    }
  ]
}

注意：只有成功完成模型转换后，该字段才会出现，若未触发转换，Manifest仅会返回原文件的基本信息。

2. URN的定义与转换说明 #

URN并非等同于文件ID，它是Forge平台对资源的标准化唯一标识：

• 文件ID：是BIM 360/ACC中Item的id字段（字符串格式），属于Data Management API的资源标识。
• URN：是将资源的完整标识（如BIM 360 Item的标识格式为urn:adsk.wipprod:fs.file:<itemId>）进行Base64编码（需去除末尾的填充字符=）后的字符串。
• 使用方式：从Data Management API获取Item时，返回结果中的urn字段已经是处理好的可直接使用的格式，无需自行转换；若你仅持有文件ID，需先拼接成完整的资源标识字符串，再做Base64编码并去掉=，最后作为Manifest API的参数。

3. Metadata方法是否替代Manifest方法 #

两者适用场景不同，无需替代：

• Manifest API：主要用于获取模型转换后的文件结构、格式信息及基础属性（如Revit版本），轻量且直接，适合仅需版本信息的场景。
• Metadata API：用于获取模型内部构件的详细元数据（如构件ID、类型、参数等），若你的应用仅需Revit版本，Manifest完全足够，无需调用Metadata API。

补充技巧：如果不想触发全量模型转换，也可以尝试调用Thumbnail API生成缩略图，部分情况下转换缩略图后Manifest也会包含Revit版本信息，比全量转换更快。

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