# 获取项目根文件夹信息

GET https://api.bimface.com/bdfs/v1/domain/hubs/{hub-id}/projects/{project-id}/root-folder

# 说明

获取项目下的根文件夹信息,包括根文件夹路径。每个项目拥有对应且唯一的根文件夹,项目下所有文件夹/文件都存放于该根文件夹下。

根文件夹和项目绑定,随项目自动创建、更新、删除,不支持针对根文件夹的移动、复制、删除等操作。

# 参数

Authorization * Bearer {accessToken} string
*为必填项
# Path
hub-id * hub-id string
project-id * 项目id string
*为必填项

# 响应

HTTP代码 说明 类型
200 OK GeneralResponseV1«FileItemWithPathDTO»
401 Unauthorized -
403 Forbidden -
404 Not Found -
# 200响应参数
GeneralResponseV1«FileItemWithPathDTO»
名称 说明 类型
code 状态代码 string
data 返回数据 FileItemWithPathDTO
physicalIndex 对象存储索引 string
fileItemId 文件id string
length 文件大小 int64
updateTime 文件更新时间 string
storeId 内部存储唯一标识 string
suffix 文件后缀 string
version 文件版本号 int32
parentId 父目录id string
path 文件夹项目下路径 string
folder 是否是文件夹 boolean
createTime 文件创建时间 string
name 文件名称 string
appKey appKey string
id versionId string
uploadMode 上传模式 string
projectId 项目id string
md5 md5 string
status 文件状态 string
message 提示信息 string

# 消耗

  • application/json

# 生成

  • application/json
  • */*

# HTTP请求示例

# 请求 path
https://api.bimface.com/bdfs/v1/domain/hubs/10000000000060002/projects/10000000006016/root-folder
# 请求 header
"Authorization: Bearer cn-e9725999-0b36-4c0e-bdca-38ea88888888"

# HTTP响应示例

# 响应 200
{
  "code" : "bimfaceservice-0000",
  "data" : {
    "appKey" : "odatvZYUSAWMbdUjTU8HoZXB9tFt6123",
    "createTime" : "2022-02-02 02:02:02",
    "fileItemId" : "10000000006016",
    "folder" : false,
    "id" : "10000000006016",
    "length" : 0,
    "md5" : null,
    "name" : "/",
    "parentId" : null,
    "path" : "/",
    "physicalIndex" : null,
    "projectId" : "10000000006016",
    "status" : "success",
    "storeId" : null,
    "suffix" : null,
    "updateTime" : "2022-02-02 02:02:02",
    "uploadMode" : null,
    "version" : 1
  },
  "message" : null
}