更新时间:2025-02-12 GMT+08:00
分享

创建一个群组空间

功能介绍

创建一个群组空间。

URI

POST /koodrive/ose/v1/space/group

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token}

X-Traceid

String

消息日志跟踪标识(必须58位)

language

String

国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语

X-User-Id

String

用户id,用于app鉴权

X-Date

String

日期,用于app鉴权

Host

String

地址,用于app鉴权

表2 请求Body参数

参数

是否必选

参数类型

描述

name

String

空间名称

iconUrl

String

空间头像

capacity

Integer

空间大小

addGroupUsers

Array of AddGroupUsers objects

添加群组用户列表

表3 AddGroupUsers

参数

是否必选

参数类型

描述

userId

String

用户id

template

Long

权限模板id,自定义模板传-1

capabilities

Capabilities object

权限值(自定义模板时传递)

表4 Capabilities

参数

是否必选

参数类型

描述

addChildNodePermission

Boolean

新建文件/文件夹权限;true有权限,false无权限。

copyPermission

Boolean

复制权限;true有权限,false无权限。

deletePermission

Boolean

删除权限;true有权限,false无权限。

downloadPermission

Boolean

下载权限;true有权限,false无权限。

editPermission

Boolean

编辑权限;true有权限,false无权限(暂不支持编辑)。

listChildNodePermission

Boolean

可见列表权限;true有权限,false无权限。

removeChildNodePermission

Boolean

移动权限;true有权限,false无权限。

renameFilePermission

Boolean

重命名权限;true有权限,false无权限。

shareFilePermission

Boolean

分享权限;true有权限,false无权限。

uploadPermission

Boolean

上传权限;true有权限,false无权限。

viewPermission

Boolean

预览权限;true有权限,false无权限。

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

code

Integer

错误码

msg

String

错误描述

failedList

Array of strings

失败列表

id

String

空间id

请求示例

创建一个群组空间为20G的群组空间。

POST /koodrive/ose/v1/space/

Authorization:Bearer+10f88**********4791e9ff

{
    "name": "api参考",
    "capacity": 20,
    "iconUrl": "1",
    "userIds": []
}

响应示例

状态码:200

基础响应,只返回错误码和错误信息。

{
  "id" : "xxx",
  "failedList" : [ ],
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

基础响应,只返回错误码和错误信息。

相关文档