部门管理接口

创建部门

• 接口描述：创建企业的部门

• 接口地址：/api/v1/base/corp/dept/add?token=TOKEN

• 方法类型：POST

• 参数形式：form-data

• 接口入参

  参数名	是否必须	参数类型	参数说明
  parentId	是	Long	上级部门ID
  name	是	String	部门名称

• 接口返回值

  参数名	参数类型	参数说明	备注
  success	是	Boolean	true成功
  code	是	String	200成功
  msg	否	String	错误时的错误信息
  obj	是		部门信息
  obj.id	是	Long	部门ID
  obj.corpId	是	String	企业部门ID
  obj.code	是	String	部门编码
  obj.name	是	String	部门名称
  obj.parentId	是	Long	上级部门ID
  obj.createTime	是	String	创建时间

修改部门名称

• 接口描述：修改部门名称

• 接口地址：/api/v1/base/corp/dept/edit?token=TOKEN

• 请求方式：POST

• 参数形式：form-data

• 接口入参

  参数名	是否必须	参数类型	参数说明
  id	是	Long	部门ID
  name	是	String	部门名称

• 接口返回值

  参数名	参数类型	参数说明	备注
  success	是	Boolean	true成功
  code	是	String	200成功
  msg	否	String	错误时的错误信息
  obj	是		部门信息
  obj.id	是	Long	部门ID
  obj.corpId	是	String	部门ID
  obj.code	是	String	部门编码
  obj.name	是	String	部门名称
  obj.parentId	是	Long	上级部门ID
  obj.createTime	是	String	创建时间

查询部门

• 接口描述：查询部门列表。
• 接口地址：/api/v1/base/corp/dept/list?token=TOKEN
• 方法类型：GET
• 接口入参

  参数名	是否必须	参数类型	参数说明
  name	否	String	部门名称关键词，模糊搜索

• 返回值示例：

  {
  "success": true,
  "code": "200",
  "msg": null,
  "obj": null,
  "map": null,
  "list": [
    {
      "id": 434,
      "parentId": 0,
      "corpId": "10a34f328c15420992359ebd492a939f",
      "name": "财务部",
      "createTime": "2022-09-02 17:46:54",
      "code": "434@",
      "level": 1
    },
    {
      "id": 466,
      "parentId": 434,
      "corpId": "10a34f328c15420992359ebd492a939f",
      "name": "销售部",
      "createTime": "2022-02-03 09:47:25",
      "code": "434@@466@",
      "level": 2
    }
  ]
  }
  

  Copy
• 接口返回值

  参数名	参数类型	参数说明	备注
  success	是	Boolean	true成功
  code	是	String	200成功
  msg	否	String	错误时的错误信息
  list	否		部门列表
  list.id	是	Long	部门ID
  list.corpId	是	String	部门ID
  list.code	是	String	部门编码
  list.name	是	String	部门名称
  list.parentId	是	Long	上级部门ID
  list.createTime	是	String	创建时间

部门删除

• 接口描述：删除部门

• 接口地址：/api/v1/base/corp/dept/delete?token=TOKEN

• 请求方式：POST

• 参数形式：form-data

• 接口入参

  参数名	必须	参数类型	参数说明
  id	是	Long	部门ID

• 接口出参

  {
    "success": true,
    "code": "200",
    "msg": null,
    "obj": null,
    "map": null,
    "list": []
  }
  

  Copy