查询企业部门架构

接口路径

GET /api/open/organization/tree

请求参数

字段	类型	是否必传	说明	限制条件	备注
enterprise_id	int	是	企业 ID	查询参数；必传	示例: 1001

请求示例

GET 'https://neolink.com/backend/api/open/organization/tree?enterprise_id=1001'

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	固定值
message	string	是	错误提示信息（成功时为空）	固定值
data	[]TreeNode	是	组织树根节点数组	树形结构；详见下表

TreeNode 对象（递归结构）

字段	类型	是否必传	说明	备注
id	int	是	组织 ID	部门唯一标识
name	string	是	组织名称	部门显示名称
enterprise_id	int	是	所属企业 ID	企业唯一标识
parent_id	int	是	父组织 ID	0=一级部门（无上级）
level	int	是	组织层级	1=一级部门；2=二级部门；以此类推
path	string	是	ID 路径	格式: "/2001/2002/2003"；表示从根到当前节点的 ID 序列
tree_path	string	是	名称路径	格式: "/总部/研发/后端组"；用于显示完整的部门路径
is_leaf	bool	是	是否叶子节点	true=无子部门；false=有子部门
children	[]TreeNode	否	子组织数组	递归结构；无子部门时为空或不包含该字段

返回示例

成功响应
{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 2001,
      "name": "总部",
      "enterprise_id": 1001,
      "parent_id": 0,
      "level": 1,
      "path": "/2001",
      "tree_path": "/总部",
      "is_leaf": false,
      "children": [
        {
          "id": 2002,
          "name": "研发",
          "enterprise_id": 1001,
          "parent_id": 2001,
          "level": 2,
          "path": "/2001/2002",
          "tree_path": "/总部/研发",
          "is_leaf": false,
          "children": [
            {
              "id": 2004,
              "name": "后端组",
              "enterprise_id": 1001,
              "parent_id": 2002,
              "level": 3,
              "path": "/2001/2002/2004",
              "tree_path": "/总部/研发/后端组",
              "is_leaf": true,
              "children": []
            },
            {
              "id": 2005,
              "name": "前端组",
              "enterprise_id": 1001,
              "parent_id": 2002,
              "level": 3,
              "path": "/2001/2002/2005",
              "tree_path": "/总部/研发/前端组",
              "is_leaf": true,
              "children": []
            }
          ]
        },
        {
          "id": 2003,
          "name": "产品",
          "enterprise_id": 1001,
          "parent_id": 2001,
          "level": 2,
          "path": "/2001/2003",
          "tree_path": "/总部/产品",
          "is_leaf": true,
          "children": []
        }
      ]
    },
    {
      "id": 2006,
      "name": "分公司",
      "enterprise_id": 1001,
      "parent_id": 0,
      "level": 1,
      "path": "/2006",
      "tree_path": "/分公司",
      "is_leaf": false,
      "children": [
        {
          "id": 2007,
          "name": "运营部",
          "enterprise_id": 1001,
          "parent_id": 2006,
          "level": 2,
          "path": "/2006/2007",
          "tree_path": "/分公司/运营部",
          "is_leaf": true,
          "children": []
        }
      ]
    }
  ]
}
错误响应
{
  "success": false,
  "message": "企业 ID 为空"
}
{
  "success": false,
  "message": "企业 ID 格式错误"
}
{
  "success": false,
  "message": "权限不足，仅企业管理员和部门管理员可查看组织树"
}
{
  "success": false,
  "message": "企业已禁用，不能进行此操作"
}