Forge API的SVF文件转换、下载及指定文件夹获取技术咨询

1. 如何通过Forge API下载SVF文件？ #

• 生成访问令牌：调用Forge认证接口，获取包含data:read权限的Bearer令牌。
• 获取衍生文件清单：发送GET /modelderivative/v2/designdata/{urn}/manifest请求，其中{urn}是上传文件的Base64编码值，接口返回所有衍生文件的结构信息。
• 定位SVF文件：在返回的manifest数据中，找到derivatives数组里类型为svf的条目，查看其children节点，提取每个文件对应的urn（文件下载标识）。
• 执行下载：发送GET /modelderivative/v2/designdata/{urn}/manifest/{derivativeUrn}请求，替换{derivativeUrn}为上一步提取的文件标识，请求头带上Authorization: Bearer <你的令牌>，即可下载对应SVF文件。

2. 转换文件为SVF并仅下载3D Views文件夹 #

文件转换步骤 #

• 上传文件到Forge存储桶：调用PUT /oss/v2/buckets/{bucketKey}/objects/{objectName}接口完成文件上传。
• 提交定向转换作业：发送POST /modelderivative/v2/designdata/job请求时，在output参数中指定仅生成3D视图，示例参数如下：

  {
    "input": {
      "urn": "<你的文件Base64编码URN>"
    },
    "output": {
      "formats": [
        {
          "type": "svf",
          "views": ["3d"]
        }
      ]
    }
  }
  

  这样转换后只会生成3D视图相关的衍生文件，从源头减少无用文件。

仅下载3D Views相关文件 #

• 过滤文件清单：调用GET /modelderivative/v2/designdata/{urn}/manifest获取清单后，只筛选role为3d或对应3D视图的衍生节点，忽略2D视图、缩略图、元数据等无关条目。
• 自定义下载逻辑：针对你使用的桌面工具，修改其下载逻辑，仅遍历并下载筛选后的3D视图文件条目，避免下载全部衍生文件，降低下载负载。

内容的提问来源于stack exchange，提问作者oğuzhan kömcü