文档首页/ ISDP/ API参考/ API接口/ 人员管理/ 查询租户下人员群组信息（API名称：findTenantGroupList）
更新时间：2025-06-16 GMT+08:00
查看PDF
分享

查询租户下人员群组信息（API名称：findTenantGroupList）

功能介绍

该接口用于查询租户下人员群组信息。

相关API

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

调用流程

图1 查询租户下人员群组信息流程

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/personGroup/findTenantGroupList

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

personGroupCode

String

否

人员群组编码，支持右模糊

personGroupName

String

否

人员群组名称，支持右模糊

start

Integer

是

分页取数下标

count

Integer

是

每页数

响应参数

参数

类型

描述

personGroupId

Long

人员群组ID

personGroupCode

String

人员群组编码

personGroupName

String

人员群组名称

level

Integer

群组层级

parentGroupId

Long

父群组ID

请求示例

{
    "personGroupCode": "",
    "personGroupName": "",
    "start": 0,
    "count": 15
}

响应示例

{
    "data": [
        {
            "personGroupId": 115821,
            "personGroupCode": "hzjTestGroup1-level2",
            "personGroupName": "hzjTestGroup1-level2",
            "level": 2,
            "parentGroupId": 115819
        },
        {
            "personGroupId": 115820,
            "personGroupCode": "hzjTestGroup2",
            "personGroupName": "hzjTestGroup2",
            "level": 1,
            "parentGroupId": null
        },
        {
            "personGroupId": 115819,
            "personGroupCode": "hzjTestGroup1",
            "personGroupName": "hzjTestGroup1",
            "level": 1,
            "parentGroupId": null
        }
    ],
    "pos": 0,
    "totalCount": 3,
    "entityName": "personGroup"
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 人员管理

相关文档