创建一个群组空间
功能介绍
创建一个群组空间。
URI
POST /koodrive/ose/v1/space/group
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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鉴权 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
空间名称 |
iconUrl |
否 |
String |
空间头像 |
capacity |
否 |
Integer |
空间大小 |
addGroupUsers |
是 |
Array of AddGroupUsers objects |
添加群组用户列表 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
userId |
是 |
String |
用户id |
template |
是 |
Long |
权限模板id,自定义模板传-1 |
capabilities |
否 |
Capabilities object |
权限值(自定义模板时传递) |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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
参数 |
参数类型 |
描述 |
---|---|---|
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 |
基础响应,只返回错误码和错误信息。 |