更新时间：2026-02-03 GMT+08:00
列举用户组成员接口 - GetUserGroupMemberList
功能介绍
查询一个群组的成员列表。
授权信息
当前API调用无需身份策略权限。
URI
GET /koodrive/ose/v1/usergroups/{group_id}/members
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
group_id | 是 | String | 群组id |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
offset | 是 | Integer | 偏移量，最小值为0 |
limit | 是 | Integer | 最大返回个数。最小值为1，最大值为100 |
keyWord | 否 | String | 搜索的关键字，可用name和ownerNamer作为关键字搜索条件 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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表示美式英语，不传默认美式英语 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
code | Integer | 响应码 |
msg | String | 响应信息 |
total | Integer | 用户组成员总数 |
userGroupMemberInfos | Array of MemberInfo objects | 成员列表 |
请求示例
查询369528171409614001的群组成员列表信息。
GET /koodrive/ose/v1/usergroups/369528171409614001/members Authorization:Bearer+c69b0f40334782d560bb154032cf22ef43d671843c4ffbad
响应示例
状态码：200
群组成员列表信息。
{
"total" : 2,
"userGroupMemberInfos" : [ {
"userId" : "1716544421723552641",
"userName" : "用户9",
"deptId" : "1716086185916545921",
"deptName" : "如意如意",
"mobile" : "002718****24846",
"role" : 0,
"top" : 0,
"createdTime" : "2026-01-21T07:19:48.245Z",
"updatedTime" : "2026-01-21T07:19:48.245Z"
}, {
"userId" : "1740611303849982849",
"userName" : "用户10",
"deptId" : "1716086185916545921",
"deptName" : "如意如意",
"mobile" : "002718****24845",
"role" : 2,
"top" : 0,
"createdTime" : "2026-01-21T08:43:01.626Z",
"updatedTime" : "2026-01-21T08:43:01.626Z"
} ],
"code" : 0,
"msg" : "success"
} 状态码
状态码 | 描述 |
|---|---|
200 | 群组成员列表信息。 |
父主题：共享文件夹成员管理
