简要描述:

  • 获取部门列表

请求域名:

  • http://xx.com

请求URL:

xx.com/business/{公众号id}/admin/getDepatmemtList

参数:

参数名 是否必须 类型 说明

返回示例:

正确时返回:

{
    "result": 1,
    "msg": "成功",
    "data": {
        "list": [
            {
                "id": 22,
                "business_id": 1,
                "name": "芸信",
                "level": 1,
                "parent_id": 0,
                "wechat_department_id": 1,
                "order": 100000000,
                "has_one_sub_department": [
                    {
                        "id": 24,
                        "business_id": 1,
                        "name": "子部门2",
                        "level": 2,
                        "parent_id": 22,
                        "wechat_department_id": 3,
                        "order": 100004000,
                        "has_one_sub_department": [
                            {
                                "id": 25,
                                "business_id": 1,
                                "name": "销售部",
                                "level": 3,
                                "parent_id": 24,
                                "wechat_department_id": 8,
                                "order": 100001000,
                                "has_one_sub_department": [
                                    {
                                        "id": 23,
                                        "business_id": 1,
                                        "name": "子部门1",
                                        "level": 4,
                                        "parent_id": 25,
                                        "wechat_department_id": 2,
                                        "order": 100000000,
                                        "has_one_sub_department": [
                                            {
                                                "id": 28,
                                                "business_id": 1,
                                                "name": "子部门1-1",
                                                "level": 5,
                                                "parent_id": 23,
                                                "wechat_department_id": 4,
                                                "order": 100000000,
                                                "has_one_sub_department": [],
                                                "staff_count": 1,
                                                "parent_name": "子部门1",
                                                "premission": {
                                                    "setDepartmentLeader": 1,
                                                    "createDepartment": 1,
                                                    "updateDepartment": 1,
                                                    "deleteDepartment": 1,
                                                    "getStaffList": 1,
                                                    "createStaff": 1,
                                                    "updateStaff": 1
                                                }
                                            }
                                        ],
                                        "staff_count": 2,
                                        "parent_name": "销售部",
                                        "premission": {
                                            "setDepartmentLeader": 1,
                                            "createDepartment": 1,
                                            "updateDepartment": 1,
                                            "deleteDepartment": 1,
                                            "getStaffList": 1,
                                            "createStaff": 1,
                                            "updateStaff": 1
                                        }
                                    }
                                ],
                                "staff_count": 0,
                                "parent_name": "子部门2",
                                "premission": {
                                    "setDepartmentLeader": 1,
                                    "createDepartment": 1,
                                    "updateDepartment": 1,
                                    "deleteDepartment": 1,
                                    "getStaffList": 1,
                                    "createStaff": 1,
                                    "updateStaff": 1
                                }
                            },
                            {
                                "id": 30,
                                "business_id": 1,
                                "name": "子部门2-2",
                                "level": 3,
                                "parent_id": 24,
                                "wechat_department_id": 6,
                                "order": 99999000,
                                "has_one_sub_department": [],
                                "staff_count": 1,
                                "parent_name": "销售部",
                                "premission": {
                                    "setDepartmentLeader": 1,
                                    "createDepartment": 1,
                                    "updateDepartment": 1,
                                    "deleteDepartment": 1,
                                    "getStaffList": 1,
                                    "createStaff": 1,
                                    "updateStaff": 1
                                }
                            },
                            {
                                "id": 31,
                                "business_id": 1,
                                "name": "子部门2-3",
                                "level": 3,
                                "parent_id": 24,
                                "wechat_department_id": 7,
                                "order": 99998000,
                                "has_one_sub_department": [
                                    {
                                        "id": 33,
                                        "business_id": 1,
                                        "name": "测试部门334",
                                        "level": 4,
                                        "parent_id": 31,
                                        "wechat_department_id": 13,
                                        "order": 10000,
                                        "has_one_sub_department": [],
                                        "staff_count": 0,
                                        "parent_name": "子部门2-3",
                                        "premission": {
                                            "setDepartmentLeader": 1,
                                            "createDepartment": 1,
                                            "updateDepartment": 1,
                                            "deleteDepartment": 1,
                                            "getStaffList": 1,
                                            "createStaff": 1,
                                            "updateStaff": 1
                                        }
                                    },
                                    {
                                        "id": 32,
                                        "business_id": 1,
                                        "name": "测试部门335",
                                        "level": 4,
                                        "parent_id": 31,
                                        "wechat_department_id": 11,
                                        "order": 9999,
                                        "has_one_sub_department": [],
                                        "staff_count": 0,
                                        "parent_name": "子部门2-3",
                                        "premission": {
                                            "setDepartmentLeader": 1,
                                            "createDepartment": 1,
                                            "updateDepartment": 1,
                                            "deleteDepartment": 1,
                                            "getStaffList": 1,
                                            "createStaff": 1,
                                            "updateStaff": 1
                                        }
                                    },
                                    {
                                        "id": 36,
                                        "business_id": 1,
                                        "name": "测试部门3399",
                                        "level": 4,
                                        "parent_id": 31,
                                        "wechat_department_id": 12,
                                        "order": 1,
                                        "has_one_sub_department": [],
                                        "staff_count": 0,
                                        "parent_name": "子部门2-3",
                                        "premission": {
                                            "setDepartmentLeader": 1,
                                            "createDepartment": 1,
                                            "updateDepartment": 1,
                                            "deleteDepartment": 1,
                                            "getStaffList": 1,
                                            "createStaff": 1,
                                            "updateStaff": 1
                                        }
                                    }
                                ],
                                "staff_count": 1,
                                "parent_name": "销售部",
                                "premission": {
                                    "setDepartmentLeader": 1,
                                    "createDepartment": 1,
                                    "updateDepartment": 1,
                                    "deleteDepartment": 1,
                                    "getStaffList": 1,
                                    "createStaff": 1,
                                    "updateStaff": 1
                                }
                            }
                        ],
                        "staff_count": 1,
                        "parent_name": "芸信",
                        "premission": {
                            "setDepartmentLeader": 1,
                            "createDepartment": 1,
                            "updateDepartment": 1,
                            "deleteDepartment": 1,
                            "getStaffList": 1,
                            "createStaff": 1,
                            "updateStaff": 1
                        }
                    },
                    {
                        "id": 26,
                        "business_id": 1,
                        "name": "x测试部门1",
                        "level": 2,
                        "parent_id": 22,
                        "wechat_department_id": 9,
                        "order": 100003500,
                        "has_one_sub_department": [
                            {
                                "id": 29,
                                "business_id": 1,
                                "name": "子部门2-1",
                                "level": 3,
                                "parent_id": 26,
                                "wechat_department_id": 5,
                                "order": 100000000,
                                "has_one_sub_department": [],
                                "staff_count": 1,
                                "parent_name": "x测试部门1",
                                "premission": {
                                    "setDepartmentLeader": 1,
                                    "createDepartment": 1,
                                    "updateDepartment": 1,
                                    "deleteDepartment": 1,
                                    "getStaffList": 1,
                                    "createStaff": 1,
                                    "updateStaff": 1
                                }
                            }
                        ],
                        "staff_count": 0,
                        "parent_name": "子部门2",
                        "premission": {
                            "setDepartmentLeader": 1,
                            "createDepartment": 1,
                            "updateDepartment": 1,
                            "deleteDepartment": 1,
                            "getStaffList": 1,
                            "createStaff": 1,
                            "updateStaff": 1
                        }
                    },
                    {
                        "id": 27,
                        "business_id": 1,
                        "name": "测试部门333",
                        "level": 2,
                        "parent_id": 22,
                        "wechat_department_id": 10,
                        "order": 100003000,
                        "has_one_sub_department": [],
                        "staff_count": 0,
                        "parent_name": "x测试部门1",
                        "premission": {
                            "setDepartmentLeader": 1,
                            "createDepartment": 1,
                            "updateDepartment": 1,
                            "deleteDepartment": 1,
                            "getStaffList": 1,
                            "createStaff": 1,
                            "updateStaff": 1
                        }
                    }
                ],
                "staff_count": 13,
                "parent_name": "",
                "premission": {
                    "setDepartmentLeader": 1,
                    "createDepartment": 1,
                    "updateDepartment": 1,
                    "deleteDepartment": 1,
                    "getStaffList": 1,
                    "createStaff": 1,
                    "updateStaff": 1
                }
            }
        ]
    }
}

错误时返回:

  {
  }

返回参数说明:

参数名 类型 说明
名称 类型 说明
data.id int 部门id
data.business_id int 企业id
data.name string 部门名称
data.level int 部门层级
data.parent_id int 上级部门id
data.parent_name string 上级部门名称
data.staff_count int 部门成员数量
data.wechat_department_id int 微信部门id,为0则是没有关联企业微信部门
data.order int 排序,值越大优先度越高
data.has_one_sub_department arr 下级部门
data.premission.setDepartmentLeader int 当前用户是否可以设置该部门领导 0不允许 1允许
data.premission.createDepartment int 当前用户是否可以在该部门下添加子部门 0不允许 1允许
data.premission.updateDepartment int 当前用户是否可以编辑该部门 0不允许 1允许
data.premission.deleteDepartment int 当前用户是否可以删除该部门 0不允许 1允许
data.premission.getStaffList int 当前用户是否可以查看该部门下的员工 0不允许 1允许
data.premission.createStaff int 创建员工时,是否可以选择该部门,员工列表的权限以获取员工列表接口为准 0不允许 1允许
data.premission.updateStaff int 编辑员工时,是否可以选择该部门,员工列表的权限以获取员工列表接口为准 0不允许 1允许