文档首页/ 云空间服务 KooDrive/ API参考/ API/ 群组管理/ 批量添加用户组成员接口
更新时间:2025-08-28 GMT+08:00

批量添加用户组成员接口

功能介绍

批量添加用户组成员接口。

URI

POST /koodrive/ose/v1/usergroups/{groupId}/members/batchAdd

表1 路径参数

参数

是否必选

参数类型

描述

groupId

String

群组id

请求参数

表2 请求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鉴权

表3 请求Body参数

参数

是否必选

参数类型

描述

amendModRoles

Array of AmendModRole objects

需要更新用户权限信息

表4 AmendModRole

参数

是否必选

参数类型

描述

userId

Long

用户id

template

Long

权限模板id,匿名模板传-1,(用户组批量添加成员或者用户组批量删除成员时非必填)

capabilities

Capabilities object

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

表5 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

表6 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

status

Integer

响应状态,0:全部成功;1:部分成功;2:全部失败

failedList

Array of strings

失败响应列表

请求示例

批量向群组369528171409614001添加用户。

POST /koodrive/ose/v1/usergroups/369528171409614001/members/batchAdd

Authorization:Bearer+c69b0f40334782d560bb154032cf22ef43d671843c4ffbad

{
  "userIds": ["3432423464657862424","132543141414141414"]
}

响应示例

状态码:200

批量添加用户响应。

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

状态码

状态码

描述

200

批量添加用户响应。