跳到主要内容

分组结构

操作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所属组idstring必填

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组idstring必填

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组idstring必填

post数据示例如下： 

{
    "group_id": "9d4d816e4189251690d6711bad697f29"
}

返回值：

{
    "status": "0",
    "errstr": "",
    "result": "",
    "trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}

错误代码说明：
无

修改分组​

定义：修改分组信息
接口：/group/modify

请求参数格式：

字段含义格式备注
group_id组idstring必填
name组名称string
parent_id父idstring

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组idstring必填
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组idstring必填
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组idstring必填
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组idstring必填
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"
}

错误代码说明：
无