部门管理

部门树的维护。

部门树

接口地址

GET /admin/dept/tree

接口参数说明

无请求参数。

响应示例

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "data": {
        "id": 1,
        "created_at": "2026-09-25T10:00:00+08:00",
        "updated_at": "2026-09-25T10:00:00+08:00",
        "name": "技术部",
        "parent_id": 0,
        "sort": 0,
        "leader": "",
        "remark": ""
      },
      "children": [
        {
          "data": {
            "id": 1,
            "created_at": "2026-09-25T10:00:00+08:00",
            "updated_at": "2026-09-25T10:00:00+08:00",
            "name": "技术部",
            "parent_id": 0,
            "sort": 0,
            "leader": "",
            "remark": ""
          },
          "children": [
            {
              "data": {
              },
              "children": [
                {
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

响应参数说明

成功时 data 为 null。

新增部门

接口地址

POST /admin/dept/add

接口参数说明

Body 参数	类型	必填	说明
id	integer	否	主键ID，新增时不传
name	string	是	部门名称
parent_id	integer	否	上级部门ID
sort	integer	否	排序
leader	string	否	负责人
remark	string	否	备注

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1,
    "created_at": "2026-09-25T10:00:00+08:00",
    "updated_at": "2026-09-25T10:00:00+08:00",
    "name": "技术部",
    "parent_id": 0,
    "sort": 0,
    "leader": "",
    "remark": ""
  }
}

响应参数说明

响应字段	类型	说明
id	integer	主键ID
created_at	string	创建时间
updated_at	string	更新时间
name	string	部门名称
parent_id	integer	上级部门ID，0 为顶级
sort	integer	排序
leader	string	负责人
remark	string	备注

修改部门

接口地址

POST /admin/dept/update

接口参数说明

Body 参数	类型	必填	说明
id	integer	否	主键ID，新增时不传
name	string	是	部门名称
parent_id	integer	否	上级部门ID
sort	integer	否	排序
leader	string	否	负责人
remark	string	否	备注

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1,
    "created_at": "2026-09-25T10:00:00+08:00",
    "updated_at": "2026-09-25T10:00:00+08:00",
    "name": "技术部",
    "parent_id": 0,
    "sort": 0,
    "leader": "",
    "remark": ""
  }
}

响应参数说明

响应字段	类型	说明
id	integer	主键ID
created_at	string	创建时间
updated_at	string	更新时间
name	string	部门名称
parent_id	integer	上级部门ID，0 为顶级
sort	integer	排序
leader	string	负责人
remark	string	备注

删除部门

接口地址

POST /admin/dept/delete

接口参数说明

Body 参数	类型	必填	说明
id	integer	是	主键ID

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明

成功时 data 为 null。