分组结构
操作BDP“账号权限”中的“分组结构”,创建、删除、编辑分组等。
分组列表
定义:获取管辖范围内的分组列表
接口:/group/list
请求参数格式: 无
返回值:(分组是可以嵌套的)
{
"status": "0",
"errstr": "",
"result": [
{
"group_level": 0, //组的层级
"seq": 0,
"group_name": "全公司", // 组的名称,默认顶级结构
"parent_group_id": "", // 父组id
"group_id": "98637b679ada6a72b993ffb303327705", //组id
"group_list": [
{
"usable": 1, // 表示有该组的权限, 如果不存在该字段,表示只是显示用
"group_level": 1,
"seq": 0,
"group_name": "我的分组",
"parent_group_id": "98637b679ada6a72b993ffb303327705",
"group_id": "105876a004682a94d745bc96a57801b0"
},
{
"group_level": 1,
"seq": 0,
"group_list": [
{
"usable": 1,
"group_level": 2,
"seq": 0,
"group_name": "黄忠剑的分组55",
"parent_group_id": "9e049f5dc707758cc523fca22d61fc3c",
"group_id": "48ad526b32638949203b0df765bc43d5"
}
],
"group_name": "解静宜的分组5",
"parent_group_id": "98637b679ada6a72b993ffb303327705",
"group_id": "9e049f5dc707758cc523fca22d61fc3c"
}
],
}
],
"trcid": "f9d50534-bbdf-32ac-bda0-7e66d14ccc9d"
}
错误代码说明:
无
创建分组
定义:创建分组, 只有超级管理员才能创建 接口:/group/create
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
name | 组名称 | string | 必填 |
parent_id | 所属组id | string | 必填 |
post数据示例如下:
{
"name": "group1",
"parent_id": "eb915ea1471cc7f02d164eac1236bbb1"
}
返回值(result返回是新创建的组id):
{
"status": "0",
"errstr": "",
"result": "9d4d816e4189251690d6711bad697f29",
"trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}
错误代码说明:
错误码 | 说明 |
---|---|
12002 | 组名称已存在 |
12004 | 所属组不存在 |
12012 | 创建的组的层次达到了上限 |
分组信息
定义:获取分组信息
接口:/group/info
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
group_id | 组id | string | 必填 |
post数据示例如下:
{
"group_id": "9d4d816e4189251690d6711bad697f29",
}
返回值(result返回是新创建的组id):
{
"status": "0",
"errstr": "",
"result": {
"parent_id": "c7fbc1002eafe7a0", // 父id
"group_id": "9d4d816e4189251690d6711bad697f29",
"name": "dztestg1",
"group_managers": [ //组所属管理员
{
"user_id": "404f19b7b9360bd09bc250650e0f6058",
"role": 2,
"name": "丁柱",
"image_name": "404f19b7b9360bd09bc250650e0f6058"
}
],
"group_users": [ // 组内用户列表
{
"user_id": "010752fa24bea08c1cafc0b264f140b2",
"name": "林皇",
"mobile": "",
"sex": "",
"role": 2,
"is_frozen": 1,
"position": "",
"email": "linhuang@haizhi.com"
}
]
},
"trcid": "29ba147e-b060-3d93-81d6-fbaee8e4ec41"
}
错误代码说明:
无
删除分组
定义:删除分组
接口:/group/delete
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
group_id | 组id | string | 必填 |
post数据示例如下:
{
"group_id": "9d4d816e4189251690d6711bad697f29"
}
返回值:
{
"status": "0",
"errstr": "",
"result": "",
"trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}
错误代码说明:
无
修改分组
定义:修改分组信息
接口:/group/modify
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
group_id | 组id | string | 必填 |
name | 组名称 | string | |
parent_id | 父id | string |
post数据示例如下:
{
"group_id": "9d4d816e4189251690d6711bad697f29",
"name": "new name",
"parent_id": "48ad526b32638949203b0df765bc43d5"
}
返回值:
{
"status": "0",
"errstr": "",
"result": "",
"trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}
错误代码说明:
无
添加分组成员
定义:添加分组成员
接口:/group/add_user
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
group_id | 组id | string | 必填 |
user_ids | 用户id列表 | json/list | 必填 |
post数据示例如下:
{
"group_id": "9d4d816e4189251690d6711bad697f29",
"user_ids": "["id_123","id_456"]"
}
返回值:
{
"status": "0",
"errstr": "",
"result": "",
"trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}
错误代码说明:
无
删除分组成员
定义:删除分组成员
接口:/group/del_user
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
group_id | 组id | string | 必填 |
user_ids | 用户id列表 | json/list | 必填 |
post数据示例如下:
{
"group_id": "9d4d816e4189251690d6711bad697f29",
"user_ids": "["id_123","id_456"]"
}
返回值:
{
"status": "0",
"errstr": "",
"result": "",
"trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}
错误代码说明:
无
添加分组管理员
定义:添加分组管理员
接口:/group/add_manager
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
group_id | 组id | string | 必填 |
user_ids | 用户id列表 | json/list | 必填 |
post数据示例如下:
{
"group_id": "9d4d816e4189251690d6711bad697f29",
"user_ids": "["id_123","id_456"]"
}
返回值:
{
"status": "0",
"errstr": "",
"result": "",
"trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}
错误代码说明:
无
删除分组管理员
定义:删除分组管理员
接口:/group/del_manager
请求参数格式:
字段 | 含义 | 格式 | 备注 |
---|---|---|---|
group_id | 组id | string | 必填 |
user_ids | 用户id列表 | json/list | 必填 |
post数据示例如下:
{
"group_id": "9d4d816e4189251690d6711bad697f29",
"user_ids": "["id_123","id_456"]"
}
返回值:
{
"status": "0",
"errstr": "",
"result": "",
"trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}
错误代码说明:
无