分组结构

操作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"
}

错误代码说明:

results matching ""

    No results matching ""