查询租户下人员群组信息(API名称:findTenantGroupList)
功能介绍
该接口用于查询租户下人员群组信息。
相关API
接口名称 |
调用说明 |
---|---|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
调用流程
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" }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。