# 新建文件夹
- 用于在直书系统里指定文件夹中创建一个空文件夹。只能在用户有编辑权限以上的文件夹下创建。
# 请求
| 基本 | |
|---|---|
| HTTP URL | https://hi-gw.weizhipin.com/open-apis/zhishu/resource/folder/create |
| HTTP Method | POST |
| 支持的应用类型 | 自建应用 |
| 权限要求 开启任一权限即可 | 资源创建 |
# 请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | user_access_token 值格式:"Bearer access_token"示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
# 请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 文件夹名称(长度超过120自动截断) 示例值:“新建文件夹” |
| folderVisitCode | list | 是 | 父文件夹的 VisitCode。参数为空字符串时,表示在用户我的文档根目录下创建文件夹 |
# 请求体示例
{
"name": "新建文件夹",
"folderVisitCode": "JdRBCrTRXsS"
}
1
2
3
4
2
3
4
# 响应
# 响应体
| 名称 | 类型 | 描述 |
|---|---|---|
| code | int | 错误码,非 0 表示失败 |
| message | string | 错误描述 |
| zpData | object | |
| -- visitCode | string | 文件夹的visitCode |
| -- url | string | 文件夹的链接地址 |
# 响应体示例
{
"code": 0,
"message": "success",
"zpData": {
"visitCode": "JdRBCrTRXsS",
"url": "https://feishu.cn/drive/folder/JdRBCrTRXsS"
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8