链接复制成功!
创建一个共享文件夹 - CreateShareFolder
功能介绍
创建一个共享文件夹
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/sharefolder/create
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 参数解释: 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
X-Traceid | 否 | String | 参数解释: 业务跟踪id(必须58位) 约束限制: 不涉及 取值范围: 长度为58位 默认值: 不涉及 |
language | 否 | String | 参数解释: 国际化语言标识 约束限制: 符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语 取值范围: 符合i18n规范 默认取值: en-US |
X-User-Id | 是 | String | 参数解释: KooDrive侧用户id,用于app鉴权 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
X-Date | 是 | String | 参数解释: 日期,用于app鉴权 约束限制: 日期格式:yyyyMMDD'T'HHmmss'Z' ; 例如20251103T070140Z 取值范围: 距当前时间15分钟以内,不能晚于当前时间 默认值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
shareType | 是 | Integer | 参数解释: 创建的共享文件夹类型 约束限制: 目前只能创建家庭共享 取值范围: 0-家庭共享 默认取值: 不涉及 |
containerId | 是 | String | 参数解释: 共享文件夹Owner的个人空间ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
name | 是 | String | 参数解释: 创建的共享文件夹名称 约束限制: 名称长度小于32 禁止包含emoji 不能为 . 或 .. 禁止包含以下字符: < > | : * ? " / 禁止包含以下空白字符: \n \r \b \t 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 标识 |
data | CreateShareFolderInfo object | 创建共享文件夹信息 |
code | Integer | 响应码 |
msg | String | 响应信息 |
请求示例
创建一个名称:测试创建共享文件夹,容器ID为:IAAFanxbXNArpAncA1645841408025905537,家庭共享文件夹
/koodrive/ose/v1/sharefolder/create
{
"shareType" : 0,
"containerId" : "IAAFanxbXNArpAncA1645841408025905537",
"name" : "测试创建共享文件夹"
} 响应示例
状态码:200
共享文件夹详细信息
{
"id" : "1765148493107805441",
"data" : {
"tenantId" : "c937ff95eeb44494a5a967e21d1852ae",
"creator" : "1644817543959100032",
"createTime" : "2025-09-01T02:34:57.815Z",
"groupId" : 1765148492881313000,
"id" : "1765148493107805441",
"shareFolderId" : "Fi94r66FoDTSP44M1VkJNup0JH-FIano0"
},
"code" : 0,
"msg" : "Success."
} 状态码
状态码 | 描述 |
|---|---|
200 | 共享文件夹详细信息 |

