Skip to content

查询用户管理部门

获取、搜索当前用户可管理的部门树,供课程工坊等场景选择所属部门。

获取用户管理根节点

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 返回当前用户可管理的直接子部门(树展开,仅一层)。

请求

参数类型必填说明
parentIdnumber父部门 ID,默认 0 表示根级
pagenumber页码,默认 0
sizenumber每页条数,默认 20

响应

PaginatorResponse 格式:

字段类型说明
dataarray分页数据
data[].idnumber组织 ID
data[].namestring组织名称
data[].parentIdnumber父组织 ID
data[].childrenNumnumber子组织数量
data[].seqnumber排序序号
data[].orgCodestring组织层级编码
data[].fullNamestring完整链路名称
data[].selectableboolean是否可勾选
paginatorobject分页信息
paginator.totalnumber总条数
paginator.sizenumber每页条数
paginator.pagenumber当前页码

请求示例

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

按组织名称模糊搜索当前用户管理范围内的部门。

请求

参数类型必填说明
namestring组织名称,模糊匹配
pagenumber页码,默认 0
sizenumber每页条数,默认 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
  }
}