组织

新增组织

接口说明

新增组织，现阶段组织只支持4级，且根组织只能有一个。

请求信息

配置说明	参数值
URL	/org
Method	POST
Content-Type	application/json

Body参数

参数名	类型	描述	是否必填
parent_id	int64	父组织id	否
name	string	组织名称，最长50位	是
code	string	组织code码，最长100位	是

Body数据样例

{
  "parent_id": 123,
  "name": "总部",
  "code": "DUZB"
}

响应数据

data数据格式

参数名	类型	描述
id	int64	组织id
parent_id	int64	父组织id
name	string	组织名称

响应数据样例

{
  "code": 0,
  "message": "success",
  "data": {
    "id": 233,
    "parent_id": 123,
    "name": "总部",
    "code": "DUZB"
  }
}

修改组织

接口说明

修改组织，现阶段只支持名称的修改。

请求信息

配置说明	参数值
URL	/org
Method	PUT
Content-Type	application/json

Body参数

参数名	类型	描述	是否必填
id	int64	组织id	是
name	string	组织名称，最长50位	是

Body数据样例

{
  "id": 123,
  "name": "总部"
}

响应数据

响应数据样例

{
  "code": 0,
  "message": "success"
}

删除组织

接口说明

删除组织，删除组织的前提是该组织下已经没有人员了。

请求信息

配置说明	参数值
URL	/org/:id
Method	DELETE

Path参数

参数名	类型	描述	是否必填
id	int64	组织id	是

响应数据

响应数据样例

{
  "code": 0,
  "message": "success"
}

查询组织列表

接口说明

查询组织列表，该查询返回的是组织树，现阶段组织树只有一颗。

请求信息

配置说明	参数值
URL	/org/list
Method	GET

响应数据

data数据格式

参数名	类型	描述
id	int64	组织id
parent_id	int64	父组织id
name	string	组织名称
code	string	组织code码
children	[]object	子组织列表，结构和父类一直，没有子组织时为空

响应数据样例

{
  "code": 0,
  "message": "success",
  "data": {
    "orgs": [
      {
        "id": 233,
        "parent_id": 3232,
        "name": "总部",
        "code": "ZB",
        "children": [
          {
            "id": 234,
            "parent_id": 233,
            "name": "集团",
            "code": "JT",
            "children": null
          }
        ]
      }
    ]
  }
}