Skip to content

组织架构

组织架构说明

组织架构的定义

组织结构说明

字段类型是否必须描述
idLONG自增 id
nameSTRING名称
codeSTRING组织编码,全局唯一
sourceSTRING组织来源,api创建固定值为internal
createdAtDATETIME创建的时间
createdByINTEGER创建用户的 id
updatedAtDATETIME最后更新的时间
updatedByINTEGER最后修改用户的 id
emailSTRING组织邮箱
parentIdINTEGER上级组织id
orderNoINTEGER组织排序号
parentCodeSTRING上级组织编码,新增修改时不是必须传递

接口说明

创建组织

创建组织。

请求URL

http
POST /api/orgs HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数

URL 参数

request body 参数

组织结构说明

返回对象的格式说明

组织结构说明

接口示例1: 创建组织

http
POST /api/orgs HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

// Request Body:
{
  "name": "组织名称",
  "description": "",
  "parentId": 29,
  "code": "112233",
  "orderNo": 1
}
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
  "version": "version@9a5e106#6730f0d",
  "code": 0,
  "msg": "success",
  "data": {
    "id": 31,
    "name": "组织名称",
    "description": "",
    "createdBy": 2,
    "createdAt": "2022-08-09 15:23:05",
    "updatedBy": 2,
    "updatedAt": "2022-08-09 15:23:05",
    "parentId": 29,
    "source": "internal",
    "code": "112233",
    "parentCode": "1122",
    "orderNo": 1
  }
}

修改组织

修改组织。

请求URL

http
PUT /api/orgs/{orgId} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数

URL 参数
字段类型是否必须说明
orgIdLONG修改组织的 id
request body 参数

组织结构说明

返回对象的格式说明

组织结构说明

接口示例1: 修改组织

http
PUT /api/orgs/{orgId} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

// Request Body:
{
  "id":31,
  "name": "组织名称updated",
  "description": "",
  "parentId": 29,
  "code": "112233",
  "orderNo": 1
}
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
  "version": "version@9a5e106#6730f0d",
  "code": 0,
  "msg": "success",
  "data": {
    "id": 31,
    "name": "组织名称updated",
    "description": "",
    "updatedBy": 2,
    "updatedAt": "2022-08-09 15:25:54",
    "parentId": 29,
    "source": "internal",
    "code": "112233",
    "parentCode": "1122",
    "orderNo": 1
  }
}

删除组织

删除组织。

请求URL

http
DELETE /api/orgs/{orgId} HTTP/1.1

请求参数

URL 参数
字段类型是否必须说明
orgIdLONG组织的 id
request body 参数

说明

组织有下级组织无法删除,组织中有用户无法删除。需要删除下级组织和用户才能删除该组织。

接口示例1: 删除组织

http
DELETE /api/orgs/{orgId} HTTP/1.1
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
  "version": "version@9a5e106#6730f0d",
  "code": 0,
  "msg": "success"
}

通过id查询组织

通过id查询组织。

请求URL

http
GET /api/orgs/{orgId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数

URL 参数
字段类型是否必须说明
orgIdLONG组织的 id
request body 参数

返回对象的格式说明

组织结构说明

接口示例1: 通过id查询组织

http
GET /api/orgs/{orgId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
  "version": "version@9a5e106#6730f0d",
  "code": 0,
  "msg": "success",
  "data": {
    "id": 31,
    "name": "组织名称updated",
    "description": "",
    "createdBy": 2,
    "createdAt": "2022-08-09 15:23:05",
    "updatedBy": 2,
    "updatedAt": "2022-08-09 15:25:54",
    "parentId": 29,
    "source": "internal",
    "code": "112233",
    "parentCode": "1122",
    "orderNo": 1
  }
}

通过code查询组织

通过code查询组织。

请求URL

http
GET /api/orgs/code/{orgCode} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数

URL 参数
字段类型是否必须说明
orgCodeSTRING组织的 code
request body 参数

返回对象的格式说明

组织结构说明

接口示例1: 通过code查询组织

http
GET /api/orgs/code/{orgCode} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
    "version": "version@9a5e106#6730f0d",
    "code": 0,
    "msg": "success",
    "data": {
        "id": 31,
        "name": "组织名称updated",
        "description": "",
        "createdBy": 2,
        "createdAt": "2022-08-09 15:23:05",
        "updatedBy": 2,
        "updatedAt": "2022-08-09 15:25:54",
        "parentId": 29,
        "source": "internal",
        "code": "112233",
        "parentCode": "1122",
        "orderNo": 1,
        "delete": false
    }
}

通过 code 修改组织

通过 code 修改组织。

请求URL

http
PUT /api/orgs/code/{orgCode} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数

URL 参数
字段类型是否必须说明
orgCodeSTRING修改组织的 code
request body 参数

组织结构说明

返回对象的格式说明

组织结构说明

接口示例1: 通过 code 修改组织

http
PUT /api/orgs/code/{orgCode} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

// Request Body:
{
  "name": "组织名称updated",
  "description": "",
  "parentId": 29,
  "code": "112233",
  "parentCode": "1122",
  "orderNo": 1
}
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
  "version": "version@9a5e106#6730f0d",
  "code": 0,
  "msg": "success",
  "data": {
    "id": 31,
    "name": "组织名称updated",
    "description": "",
    "updatedBy": 2,
    "updatedAt": "2022-08-09 15:25:54",
    "parentId": 29,
    "source": "internal",
    "code": "112233",
    "parentCode": "1122",
    "orderNo": 1
  }
}

通过 code 删除组织

通过 code 删除组织。

请求URL

http
DELETE /api/orgs/code/{orgCode} HTTP/1.1

请求参数

URL 参数
字段类型是否必须说明
orgCodeSTRING组织的 code
request body 参数

说明

组织有下级组织无法删除,组织中有用户无法删除。需要删除下级组织和用户才能删除该组织。

接口示例1: 通过 code 删除组织

http
DELETE /api/orgs/code/{orgCode} HTTP/1.1
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
  "version": "version@9a5e106#6730f0d",
  "code": 0,
  "msg": "success"
}

查询组织列表

查询组织列表。

请求URL

http
GET /api/orgs HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数

URL 参数
字段类型是否必须说明
parentIdLONG组织的父级 id ,不传则从根结点查询
fetchChildBOOLEAN是否递归查询所有下级组织,默认为false
request body 参数

返回对象的格式说明

组织结构说明

接口示例1: 查询组织列表

http
GET /api/orgs HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
    "version": "version@9a5e106#6730f0d",
    "code": 0,
    "msg": "success",
    "data": [
        {
            "id": 1,
            "name": "第一级组织",
            "description": "",
            "createdBy": 2,
            "createdAt": "2022-08-09 10:37:35",
            "updatedBy": 2,
            "updatedAt": "2022-08-09 10:37:35",
            "source": "internal",
            "code": "1",
            "orderNo": 0,
            "delete": false
        }
    ]
}

查询子部门及用户

查询组织列表。

请求URL

http
GET /api/orgs/depts-users?parentId={parentId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数

URL Query 参数
字段类型是否必须说明
parentIdLONG组织的父级 id ,不传则从根结点查询

返回对象的格式说明

字段类型说明
versionSTRING当前系统版本哈希值
data.subOrgsJSON ARRAY组织结构说明
data.usersJSON ARRAY用户结构说明

接口示例1: 查询子部门及用户

http
GET /api/orgs/depts-users?parentId={parentId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...
http
HTTP/1.1 200 Ok
Content-Type: application/json

{
  "version": "version@9a5e106#6730f0d",
  "code":0,
  "msg":"success",
  "data":{
    "subOrgs":[
      {
        "id":23,
        "name":"开发部",
        "description":"",
        "createdBy":11630,
        "createdAt":"2023-07-12 15:23:48",
        "updatedBy":11630,
        "updatedAt":"2023-07-12 15:23:48",
        "parentId":1,
        "code":"490058140",
        "parentCode":"1",
        "orderNo":1,
        "delete":false
      }
    ],
    "users":[
      {
        "id":159,
        "name":"test",
        "email":"anonymous@hengshi.com",
        "description":"user import from LDAP.",
        "isDelete":false,
        "loginName":"test"
      }
    ]
  }
}

HENGSHI SENSE API 使用手册