查询下一级部门信息 - QueryNextLevelDepartment_部门管理接口_组织管理接口_用户组织管理API_IPDCenter基础服务API_API参考

功能介绍

查询下一级部门信息。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /basic/mgmt/public/api/v1/organization/group/nextLevel

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	JWTToken

表2 请求路径参数
参数	是否必选	参数类型	描述
id	是	long	部门ID
currentLevel	否	Integer	传入部门当前层级，不传默认第一层，传入值会影响出参中层级的值

响应参数

状态码： 200

表3 响应Body参数
参数	参数类型	描述
code	String	返回码
message	String	返回码描述
datas	GroupVo	返回数据
totalCount	Long	数量条数

表4 GroupVo
参数	参数类型	描述
id	String	角色ID
name	String	角色名称
nameEn	String	英文名称
groupcode	String	部门编码
groupType	String	部门来源
description	String	描述
descriptionEn	String	英文描述
creator	String	创建人
createTime	Timestamp	创建时间
rdmVersion	Integer	系统版本
parentCrumb	Array of XDMUserGroupViewDTO	祖先面包屑
children	Array of GroupVo	子部门
employeeCount	Integer	现有员工数量
extId	Long	扩展信息ID
manager	Long	负责人
managerName	String	负责人名称
employeeLimit	Integer	限制人数
level	Integer	所处层级
parentId	Long	父部门编码
rdmDeleteFlag	Integer	是否删除标识
modifier	String	修改人
className	String	类名
disableFlag	Boolean	失效标识
rdmExtensionType	String	扩展类型
tenant	TenantViewDTO	租户
lastUpdateTime	Timestamp	最新更新时间

表5 XDMUserGroupViewDTO
参数	参数类型	描述
id	String	角色ID
name	String	角色名称
nameEn	String	英文名称
groupcode	String	部门编码
groupType	String	部门来源
description	String	描述
descriptionEn	String	英文描述
creator	String	创建人
createTime	Timestamp	创建时间
rdmVersion	Integer	系统版本
rdmDeleteFlag	Integer	是否删除标识
modifier	String	修改人
className	String	类名
disableFlag	Boolean	失效标识
rdmExtensionType	String	扩展类型
tenant	TenantViewDTO	租户
lastUpdateTime	Timestamp	最新更新时间

表6 TenantViewDTO
参数	参数类型	描述
id	String	租户ID
rdmVersion	Integer	系统版本
creator	String	创建人
kiaguid	String	KIA密级
code	String	租户编码
rdmDeleteFlag	Integer	是否删除标识
modifier	String	修改人
description	String	描述
className	String	类名
name	String	名称
nameEn	String	英文名称
securityLevel	String	安全密级
createTime	Timestamp	创建时间
disableFlag	Boolean	失效标识
rdmExtensionType	String	扩展类型
dataSource	String	租户使用的数据源名称
tenant	TenantViewDTO	租户
lastUpdateTime	Timestamp	最新更新时间

状态码： 400

表7 响应Body参数
参数	参数类型	描述
reserve	String	保留字段
error_code	String	错误编码
error_msg	String	错误信息

请求示例

/basic/mgmt/public/api/v1/organization/group/nextLevel?id=739517047683162112

响应示例

状态码： 200

成功

{
    "code": "IPDC.01020000",
    "message": "success",
    "datas": {
        "id": "739517047683162112",
        "creator": "public@ipdcenter203.huaweiapaas.com 2891572111",
        "modifier": "public@ipdcenter203.huaweiapaas.com 2891572111",
        "createTime": "2025-03-07T08:16:43.730+00:00",
        "lastUpdateTime": "2025-03-07T08:16:43.730+00:00",
        "rdmVersion": 1,
        "rdmDeleteFlag": 0,
        "rdmExtensionType": "XDMUserGroup",
        "tenant": {
            "id": "-1",
            "creator": "xdmAdmin",
            "modifier": "xdmAdmin",
            "createTime": "2023-10-31T07:44:53.458+00:00",
            "lastUpdateTime": "2023-10-31T07:44:53.458+00:00",
            "rdmVersion": 1,
            "rdmDeleteFlag": 0,
            "rdmExtensionType": "Tenant",
            "tenant": null,
            "className": "Tenant",
            "name": "basicTenant",
            "description": "默认租户",
            "kiaguid": null,
            "securityLevel": "internal",
            "nameEn": null,
            "code": "basicTenant",
            "disableFlag": false,
            "dataSource": "DefaultDataSource"
        },
        "className": "XDMUserGroup",
        "groupcode": "GSK118",
        "nameEn": "testYhz202503071056",
        "descriptionEn": "hasChildren",
        "name": "testYhz202503071056",
        "description": "testYhz202503071056",
        "disableFlag": false,
        "extId": "106",
        "employeeCount": 0,
        "employeeLimit": 5,
        "manager": null,
        "managerName": null,
        "parentId": null,
        "children": [
            {
                "id": "741608922581835776",
                "creator": "public@ipdcenter203.huaweiapaas.com 2891572111",
                "modifier": "public@ipdcenter203.huaweiapaas.com 2891572111",
                "createTime": "2025-03-13T02:49:05.571+00:00",
                "lastUpdateTime": "2025-03-13T02:49:05.571+00:00",
                "rdmVersion": 1,
                "rdmDeleteFlag": 0,
                "rdmExtensionType": "XDMUserGroup",
                "tenant": {
                    "id": "-1",
                    "creator": "xdmAdmin",
                    "modifier": "xdmAdmin",
                    "createTime": "2023-10-31T07:44:53.458+00:00",
                    "lastUpdateTime": "2023-10-31T07:44:53.458+00:00",
                    "rdmVersion": 1,
                    "rdmDeleteFlag": 0,
                    "rdmExtensionType": "Tenant",
                    "tenant": null,
                    "className": "Tenant",
                    "name": "basicTenant",
                    "description": "默认租户",
                    "kiaguid": null,
                    "securityLevel": "internal",
                    "nameEn": null,
                    "code": "basicTenant",
                    "disableFlag": false,
                    "dataSource": "DefaultDataSource"
                },
                "className": "XDMUserGroup",
                "groupcode": "GSK119",
                "nameEn": "testYhz202503131055",
                "descriptionEn": null,
                "name": "testYhz202503131055",
                "description": "testYhz202503131055",
                "disableFlag": false,
                "extId": "107",
                "employeeCount": 0,
                "employeeLimit": 5,
                "manager": null,
                "managerName": null,
                "parentId": "739517047683162112",
                "children": null,
                "level": 2,
                "parentCrumb": null
            }
        ],
        "level": 1,
        "parentCrumb": null
    },
    "totalCount": null
}

状态码： 401

认证失败

{
  "error_code" : "IPDC.02010034",
  "error_msg" : "Authorization token incorrect"
}

状态码

状态码	描述
200	成功
401	认证失败
500	服务器内部异常

错误码

请参见错误码。

查询下一级部门信息 - QueryNextLevelDepartment