Skip to content

获取我的空间(根文件夹)元数据

获取用户“我的空间”(根文件夹)的元数据,包括根文件夹的 token、ID 和文件夹所有者的 ID。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/drive/explorer/v2/root_folder/meta
HTTP MethodGET
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可drive:drive 查看、评论、编辑和管理云空间中所有文件 drive:drive.metadata:readonly 查看云空间中文件元数据

Tip: 了解更多权限相关信息,参考云文档常见问题

请求头

名称类型必填描述
Authorizationstring应用调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,参考选择并获取访问凭证值格式:"Bearer access_token" 可选值如下: - tenant_access_token: 以应用身份调用 API,可读写的数据范围由应用自身的数据权限范围决定。参考自建应用获取 tenant_access_token商店应用获取 tenant_access_token示例值:"Bearer t-g1044qeGEDXTB6NDJOGV4JQCYDGHRBARFTGT1234" - user_access_token: 以用户身份调用 API,可读写的数据范围由用户的的数据权限范围决定。参考获取 user_access_token示例值:"Bearer u-cjz1eKCEx289x1TXEiQJqAh5171B4gDHPq00l0GE1234"

cURL示例

bash
curl --location 'https://open.feishu.cn/open-apis/drive/explorer/v2/root_folder/meta' \
--header 'Authorization: Bearer t-e13d5ec1954e82e458f3ce04491c54ea8c9abcef'

响应

响应体

名称类型描述
tokenstring文件夹的 token
idstring文件夹的 ID
user_idstring文件夹所有者的 ID

响应体示例

json
{
  "code": 0,
  "msg": "Success",
  "data": {
    "token": "nodbcbHUdOsS613xVzTzFEabcef",
    "id": "7110173013420512356",
    "user_id": "7103496998321312356"
	}
}

错误码

以下为本接口相关错误码。了解其它通用错误码,参考通用错误码

错误码错误信息排查建议
91201FAILED处理失败。请稍后重试或联系技术支持
91204FORBIDDEN当前应用或用户没有权限。参考本文档“请求”部分的权限要求为应用或用户开启对应权限。了解更多,参考云空间常见问题

内容来源:飞书开放平台 · 自动爬取整理