Skip to content

部门接口

部门管理相关接口。

部门列表

获取部门列表(树形结构)。

请求

GET /api/v1/depts

请求参数

参数类型必填说明
namestring部门名称,模糊查询
statusint状态:0-禁用 1-启用

响应

json
{
  "code": "00000",
  "msg": "成功",
  "data": [
    {
      "id": 1,
      "parentId": 0,
      "name": "有来科技",
      "code": "YOULAI",
      "leader": "张三",
      "phone": "13800138000",
      "email": "admin@youlai.tech",
      "sort": 1,
      "status": 1,
      "treePath": "1",
      "children": [
        {
          "id": 2,
          "parentId": 1,
          "name": "研发部",
          "code": "DEV",
          "leader": "李四",
          "sort": 1,
          "status": 1,
          "treePath": "1,2"
        }
      ]
    }
  ]
}

部门详情

请求

GET /api/v1/depts/{id}

响应

json
{
  "code": "00000",
  "msg": "成功",
  "data": {
    "id": 2,
    "parentId": 1,
    "name": "研发部",
    "code": "DEV",
    "leader": "李四",
    "phone": "13800138001",
    "email": "dev@youlai.tech",
    "sort": 1,
    "status": 1
  }
}

新增部门

请求

POST /api/v1/depts

请求参数

json
{
  "parentId": 1,
  "name": "测试部",
  "code": "QA",
  "leader": "王五",
  "phone": "13800138002",
  "email": "qa@youlai.tech",
  "sort": 3,
  "status": 1
}

响应

json
{
  "code": "00000",
  "msg": "成功",
  "data": 10
}

修改部门

请求

PUT /api/v1/depts/{id}

响应

json
{
  "code": "00000",
  "msg": "成功"
}

删除部门

请求

DELETE /api/v1/depts/{id}

响应

json
{
  "code": "00000",
  "msg": "成功"
}

部门下拉树

获取部门树形下拉选项。

请求

GET /api/v1/depts/tree

响应

json
{
  "code": "00000",
  "msg": "成功",
  "data": [
    {
      "value": 1,
      "label": "有来科技",
      "children": [
        { "value": 2, "label": "研发部" },
        { "value": 3, "label": "产品部" }
      ]
    }
  ]
}

基于 MIT 许可发布