# 查询及下载指定版本文件

通过文件管理服务上传新版本后，可查询版本文件的配置信息，也可将其下载至浏览器默认路径或本地指定路径。在上一节中您已学会了如何上传版本文件，本节将介绍如何查询指定版本文件信息，如何下载以及删除指定版本文件。

# 1. 查询指定版本文件信息

若您希望查询到“"BIMFACE示例文件"第5个版本的文件信息，那么您可以记录下版本文件ID(fileId)，通过获取指定版本文件信息 (opens new window)查询该版本的配置属性，包括名称、访问权限以及其他元数据。

# HTTP请求示例

# 请求 path

GET https://api.bimface.com/bdfs/data/v1/projects/10000022120160/files/10000022340099/meta

"Authorization: Bearer cn-e9725999-0b36-4c0e-bdca-38ea88888888"

# HTTP响应示例

# 响应 200

{
  "code": "success",
  "message": null,
  "data" : {
    "appKey" : "odatvZYUSAWMbdUjTU8HoZXB9tFt6123",
    "createTime": "2023-03-15 13:18:47",
    "id": "10000022340099",
    "fileId": "10000022340099",
    "fileItemId": "10000022260842",
    "name": "示例文件.rvt",
    "fileItemName": "BIMFACE示例文件.rvt",
    "suffix": "rvt",
    "length": 6459392,
    "projectId": "10000022120160",
    "parentId": "10000022200497",
    "folder": false,
    "storeId": "10000022340097",
    "version": 5,
    "status": "SUCCESS",
    "uploadMode": "GENERAL",
    "md5": "af02c0906f369ae2029ef04afdb1913f",
    "physicalIndex": "d03821c0d4eb4416ae01e2a03723a32b",    
    "updateTime": "2023-03-15 13:18:47",
    "originalCreateTime": "2023-03-08 11:08:50"
  }
}

# 2. 下载指定版本文件

你可以通过下载指定版本文件 (opens new window)接口获取文件。其中获取文件的URL可将下载链接分享给其他人，也可设置链接失效时间。

# HTTP请求示例

# 请求 path

GET https://api.bimface.com/bdfs/data/v1/projects/10000022120160/files/10000022200514/downloadUrl

# 请求 header

"Authorization: Bearer cn-e9725999-0b36-4c0e-bdca-38ea88888888"

# HTTP响应示例

# 响应 200

{
  "code": "success",
  "message": null,
  "data": "https://bf-local-srcfile.oss-cn-shanghai.aliyuncs.com/19f974c24d4b4749be0b7da6a6ae3e37?Expires=1677557417&OSSAccessKeyId=QLYNXu7B9OTjErYR&Signature=QWgNyCDcrhbIxY1rp6F%2BWs7pgxs%3D&response-content-disposition=attachment%3Bfilename%3D%22BIMFACE%25E7%25A4%25BA%25E4%25BE%258B%25E6%2596%2587%25E4%25BB%25B6%252B%2528%25E6%25B5%2581%25E5%25BC%258F%25E5%258A%25A0%25E8%25BD%25BDV3.0%2529.rvt%22%3Bfilename%2A%3Dutf-8%27%27BIMFACE%25E7%25A4%25BA%25E4%25BE%258B%25E6%2596%2587%25E4%25BB%25B6%252B%2528%25E6%25B5%2581%25E5%25BC%258F%25E5%258A%25A0%25E8%25BD%25BDV3.0%2529.rvt"
}

# 3. 删除指定版本文件

文件管理服务支持批量删除版本文件，举例说明，如果您希望删除"BIMFACE示例图纸"中的第3个版本和"BIMFACE示例模型"中的第4个版本，您需要获取到版本文件ID(10000022200514、10000022320357)，然后使用删除指定版本文件 (opens new window)接口。

# HTTP请求示例

# 请求 path

DELETE https://api.bimface.com/bdfs/data/v1/projects/10000022120160/files

# 请求 header

"Authorization: Bearer cn-e9725999-0b36-4c0e-bdca-38ea88888888"

# 请求 body

[
    "10000022200514",
    "10000022320357"
]

# HTTP响应示例

# 响应 200

{
  "code": "success",
  "message": null,
  "data": "success"
}

← 上传版本文件获取Hub列表 →