文档首页/ ISDP/ API参考/ API接口/ 人员管理/ 查询租户下人员群组信息(API名称:findTenantGroupList)
更新时间:2024-01-18 GMT+08:00
分享

查询租户下人员群组信息(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"
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档