Appearance
查询用户管理部门
获取、搜索当前用户可管理的部门树,供课程工坊等场景选择所属部门。
获取用户管理根节点
GET /api/admin/org/user_manage_root
权限 admin
获取组织根节点信息。根节点不存在时返回 404。selectable 表示当前用户是否有该根节点的管理权限。
响应示例
json
{
"id": 1,
"name": "集团",
"parentId": 0,
"childrenNum": 5,
"seq": 0,
"orgCode": "1",
"fullName": "集团",
"selectable": true
}获取部门子节点
GET /api/admin/org/user_manage_children
权限 admin
按父部门 ID 返回当前用户可管理的直接子部门(树展开,仅一层)。
请求
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| parentId | number | 否 | 父部门 ID,默认 0 表示根级 |
| page | number | 否 | 页码,默认 0 |
| size | number | 否 | 每页条数,默认 20 |
响应
PaginatorResponse 格式:
| 字段 | 类型 | 说明 |
|---|---|---|
| data | array | 分页数据 |
| data[].id | number | 组织 ID |
| data[].name | string | 组织名称 |
| data[].parentId | number | 父组织 ID |
| data[].childrenNum | number | 子组织数量 |
| data[].seq | number | 排序序号 |
| data[].orgCode | string | 组织层级编码 |
| data[].fullName | string | 完整链路名称 |
| data[].selectable | boolean | 是否可勾选 |
| paginator | object | 分页信息 |
| paginator.total | number | 总条数 |
| paginator.size | number | 每页条数 |
| paginator.page | number | 当前页码 |
请求示例
GET /api/admin/org/user_manage_children?parentId=0&page=0&size=20响应示例
json
{
"data": [
{
"id": 2,
"name": "华东区",
"parentId": 1,
"childrenNum": 3,
"seq": 0,
"orgCode": "1.2",
"fullName": "华东区",
"selectable": true
}
],
"paginator": {
"total": 1,
"size": 20,
"page": 0
}
}按名称搜索部门
GET /api/admin/org/user_manage_search
权限 admin
按组织名称模糊搜索当前用户管理范围内的部门。
请求
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 组织名称,模糊匹配 |
| page | number | 否 | 页码,默认 0 |
| size | number | 否 | 每页条数,默认 20 |
响应
PaginatorResponse 格式,同「获取部门子节点」,参见上节。
请求示例
GET /api/admin/org/user_manage_search?name=研发&page=0&size=20响应示例
json
{
"data": [
{
"id": 5,
"name": "研发部",
"parentId": 3,
"childrenNum": 0,
"seq": 0,
"orgCode": "1.2.3.5",
"fullName": "华东区-上海-研发部",
"selectable": true
}
],
"paginator": {
"total": 1,
"size": 20,
"page": 0
}
}