主题
查询用户组
- 本接口返回的是业务域下的所有用户组
- 对规则组,本接口不返回对应的规则定义
接口说明
请求URL:http[s]://{网关地址}/minos-platform/group/search
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求体
| 字段名 | 参数名 | 是否必填 | 类型 | 描述 |
|---|---|---|---|---|
| 所属域 | domainId | M | String | 所属业务域ID |
请求示例
json
{
"domainId":"-200"
}1
2
3
2
3
响应说明
响应体
| 字段名 | 参数名 | 是否必填 | 类型 | 描述 |
|---|---|---|---|---|
| 返回码 | errcode | M | String | 返回码,0 成功,其他为错误 |
| 返回码描述 | errmsg | M | Sring | 返回码描述 |
| 返回对象 | data | O | List<Group> | 返回的用户组对象 |
| 字段名 | 参数名 | 是否必填 | 类型 | 描述 |
|---|---|---|---|---|
| 用户组id | groupId | M | String | 用户组编码 |
| 用户组名称 | groupName | M | String | 用户组名称 |
| 所属域 | domainId | M | String | 所属域ID |
| 数据源名称 | datasourceName | O | String | 当为外部数据用户组类型时返回此字段 |
| 动态组sql语句 | dynamicSql | O | String | 当为外部数据用户组类型时返回此字段 |
| 数据源wid | datasourceWid | O | String | 当为外部数据用户组类型时返回此字段 |
| 备注 | groupRemark | O | String | 备注 |
| 自动更新 | autoSyn | O | int | 0:不开启 1:开启 |
| 间隔时间 | syncPeriod | O | int | 间隔时间 |
| 间隔时间单位 | syncPeriodUnit | O | String | 1:分钟 2:小时 3:天 |
| 首次同步时间 | firstSyncTime | O | String | 格式yyyy-MM-dd HH:mm:ss |
| 上次同步时间 | lastSyncTime | O | String | 格式yyyy-MM-dd HH:mm:ss |
响应示例
json
{
"errcode": "0",
"errmsg": "操作成功",
"data": [
{
"groupId": "gp001",
"groupName": "gp001Rename",
"groupType": "2",
"domainId": "-200",
"domainName": "门禁域",
"datasourceName": "61platform",
"datasourceWid": "1001147653935230976",
"dynamicSql": "2wvg/eeQmxeVr2mXTWxkdEUQYtbBCsYxm+kH6MDqtXi2mM15DJSfuvzHSvsr7JmR",
"autoSyn": 1,
"syncPeriod": 1,
"syncPeriodUnit": "1",
"firstSyncTime": "2022-08-25 16:00:01",
"lastSyncTime": "2022-08-25 14:04:22"
},
{
"groupId": "996800323496935424",
"groupName": "test1111",
"groupType": "0",
"domainId": "-200",
"domainName": "门禁域",
"datasourceName": "",
"datasourceWid": "",
"dynamicSql": "",
"autoSyn": 0,
"syncPeriod": null,
"syncPeriodUnit": "",
"firstSyncTime": "",
"lastSyncTime": ""
}
]
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
错误码
| 错误码 | 描述 |
|---|---|
| 111001 | 必填参数不能为空 |
| 111002 | 请求参数格式错误 |
| 111007 | 业务域不存在 |
Demo
java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
GroupSearchRequest request = new GroupSearchRequest();
request.setDomainId("-100");
BaseResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()) {
//.....
}1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11

