主题
向用户组添加用户
只允许向非系统域下的普通组中添加用户
接口说明
请求URL:http[s]://{网关地址}/minos-platform/group/addUserToGroup
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求体
| 字段名 | 参数名 | 是否必填 | 类型 | 描述 |
|---|---|---|---|---|
| 用户组id | groupId | M | String | 用户组编码 |
| 用户名(学工号) | userIds | M | String[] | 用户名/学工号,最大20个字符 |
| 分类类型 | onoroffCampusType | O | int | 分类类型 1校内(默认) 2校外 |
请求示例
json
{
"userIds":["wxtTest01"],
"groupId":"gp002",
"onoroffCampusType": 1
}1
2
3
4
5
2
3
4
5
响应说明
注意:返回状态码116011时,表示部分用户已经添加成功
响应体
| 字段名 | 参数名 | 是否必填 | 类型 | 描述 |
|---|---|---|---|---|
| 返回码 | errcode | 是 | String | 返回码,0 成功,其他为错误 |
| 返回码描述 | errmsg | 是 | Sring | 返回码描述 |
| 失败的用户名列表 | data | 否 | Object[] | 失败的用户名/学工号列表 |
响应示例
json
{
"errcode": "0",
"errmsg": "操作成功",
"data": null
}1
2
3
4
5
2
3
4
5
错误码
| 错误码 | 描述 |
|---|---|
| 111001 | 必填参数不能为空 |
| 111002 | 请求参数格式错误 |
| 111009 | 用户组id不存在 |
| 116011 | 部分成功(用户组中已经包含该用户,或用户不存在(包含归档)) |
| 116012 | 非普通组,不允许添加用户 |
| 116017 | 全部失败 |
Demo
java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
AddUserToGroupRequest request = new AddUserToGroupRequest();
request.setGroupId("grouptest001");
request.setUserIds(new String[]{"campususertest001","campususertest999"});
BaseResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()) {
//.....
}1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12

