获取项目根文件夹信息

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

说明

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

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

参数

Header

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
}