Skip to content

新建文件夹

该接口用于根据 folderToken 在该 folder 下创建文件夹。

Error: 为了更好地提升该接口的安全性,我们对其进行了升级,请尽快迁移至 新版本>>

Warning: 该接口不支持并发创建,且调用频率上限为 5QPS 以及 10000次/天

请求

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

请求头

名称类型必填描述
Authorizationstringtenant_access_token or user_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

Note 关于云文档接口的 AccessToken 调用说明详见 云文档接口快速入门

路径参数

参数类型必须说明
folderTokenstring文件夹的 token,获取方式见 概述

请求体

参数类型必须说明
titlestring文件夹标题

请求体示例

json
{
	"title": "string"
}

响应

响应体

参数说明
url新创建文件夹的 url
revision新创建文件夹的版本号
token新创建文件夹的 token

响应体示例

json
{
	"code": 0,
	"msg": "Success",
	"data": {
		"url": "string",
    	"revision": 0,
    	"token": "string"
    }
}

错误码

错误码说明排查建议
91201FAILED处理失败,稍后重试。
91202PARAMERR参数错误,检查参数是否正确,如:typefileTokendstFolderToken
91203NOTEXIST请检查请求参数是否正确,如:typefileToken是否匹配。
91204FORBIDDEN检查当前账户对文档、文件夹的权限。参考接入流程授权
91205DELETED来源文件已被删除,检查是否还存在。
91206OUT_OF_LIMIT超过限制。
91207DUPLICATE重复记录。
91208REVIEW内容审查不通过。

具体可参考:服务端错误码说明

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