Appearance
用户组
按类型批量添加成员
POST /api_v3/admin/user_groups/{id}/members- 支持版本
>=26.1.4 - 权限
admin_user_group_manage
参数
| 参数 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| id | path | integer | 是 | 用户组 ID(user_group.id) |
| type | body | string | 是 | 成员类型:user(用户)、org(部门)、post(岗位) |
| memberIds | body | integer[] | 是 | 成员主体 id 数组:type=user 为用户 id,type=org 为部门 id,type=post 为岗位 id。type=user 时仅处理非系统、非已删除用户。单次最多 1000 条 |
响应
json
{
"status": true,
"data": {
"added": [
{
"type": "user",
"memberId": "1"
},
{
"type": "user",
"memberId": "2"
}
],
"skipped": []
}
}字段说明
| 参数 | 类型 | 说明 |
|---|---|---|
| status | boolean | 成功 |
| data | object | 结果 |
| data.added | array | 本次新加入的成员列表 |
| data.added[].type | string | 成员类型:user / org / post |
| data.added[].memberId | string | 成员主体 id |
| data.skipped | array | 请求的 memberIds 中已在组内、未重复添加的成员列表 |
| data.skipped[].type | string | 成员类型:user / org / post |
| data.skipped[].memberId | string | 成员主体 id |