创建组织信息

接口地址:/openapi/organization

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "alias": "",
  "description": "",
  "enabled": false,
  "functionType": "",
  "id": 0,
  "latitude": "",
  "leader": 0,
  "longitude": "",
  "name": "",
  "parentOrgId": 0,
  "type": "",
  "specialCode":"",
  "parentSpecialCode":""
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
open-platform Organization对象Req 组织 body true open-platform Organization对象Req open-platform Organization对象Req
  parentOrgId 如果不是根节点，必须指定父级组织ID false integer(int64)
  name 组织名称 true string
  type 组织类型（集团(GROUP)、公司(COMPANY)、部门(DEPARTMENT)、区域(暂时不可用)..） true string
  enabled 是否启用 true boolean
  leader 负责人 false integer(int64)
  functionType 职能类型 false string
  alias 别名 false string
  description 描述 false string
  id false integer(int64)
  latitude 纬度 true string
  longitude 经度 true string
  specialCode 第三方编码 false string 对接第三方编码的用户需必传，否则会清空该值
  parentSpecialCode 第三方父级编码 false string

响应状态:

状态码 说明 schema
200 OK R«long»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data integer(int64) integer(int64)
message string
successful boolean

响应示例:

{
    "code": 0,
    "data": 0,
    "message": "",
    "successful": true
}

根据条件查询组织树

接口地址:/openapi/organization/query/list

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "code": "",
  "functionType": "",
  "name": "",
  "parentOrgId": 0,
  "type": "",
  "specialCode":""
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
open-platform Organization 请求对象 组织 body true open-platform Organization 请求对象 open-platform Organization 请求对象
  code 组织编码 false string
  functionType 职能类型 false string
  name 组织名称 false string
  parentOrgId 父级组织id false integer(int64)
  type 组织类别（集团(GROUP)、公司(COMPANY)、部门(DEPARTMENT)、区域(暂时不可用)..） false string
  specialCode 第三方编码 false string

响应状态:

状态码 说明 schema
200 OK R«List«open-platform Organization对象»»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data array open-platform Organization对象Res
  alias 别名 string
  children 子集 array open-platform Organization对象Res
  code 组织编码 string
  description 描述 string
  enabled 是否启用 boolean
  functionType 职能类型 string
  id ID integer(int64)
  latitude 纬度 string
  leader 负责人 integer(int64)
  longitude 经度 string
  name 组织名称 string
  parentOrgId 父级组织ID integer(int64)
  specialCode 第三方编码 string
  type 组织类型（集团(GROUP)、公司(COMPANY)、部门(DEPARTMENT)、区域(暂时不可用)..） string
message string
successful boolean

响应示例:

{
    "code": 0,
    "data": [
        {
            "alias": "",
            "children": [
                {
                    "alias": "",
                    "children": [
                        {}
                    ],
                    "code": "",
                    "description": "",
                    "enabled": false,
                    "functionType": "",
                    "id": 0,
                    "latitude": "",
                    "leader": 0,
                    "longitude": "",
                    "name": "",
                    "parentOrgId": 0,
                    "type": ""
                }
            ],
            "code": "",
            "description": "",
            "enabled": false,
            "functionType": "",
            "id": 0,
            "latitude": "",
            "leader": 0,
            "longitude": "",
            "name": "",
            "parentOrgId": 0,
            "type": ""
        }
    ],
    "message": "",
    "successful": true
}

根据条件查询组织列表（非树结构）

接口地址:/openapi/organization/query/simpleList

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "code": "",
  "functionType": "",
  "name": "",
  "parentOrgId": 0,
  "type": "",
  "specialCode":""
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
open-platform Organization 请求对象 组织 body true open-platform Organization 请求对象 open-platform Organization 请求对象
  code 组织编码 false string
  functionType 职能类型 false string
  name 组织名称 false string
  parentOrgId 父级组织id false integer(int64)
  type 组织类别（集团(GROUP)、公司(COMPANY)、部门(DEPARTMENT)、区域(暂时不可用)..） false string
  specialCode 第三方编码 false string

响应状态:

状态码 说明 schema
200 OK R«List«open-platform Organization对象»»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
code integer(int32) integer(int32)
data array open-platform Organization对象Res
  alias 别名 string
  code 组织编码 string
  description 描述 string
  enabled 是否启用 boolean
  functionType 职能类型 string
  id ID integer(int64)
  latitude 纬度 string
  leader 负责人 integer(int64)
  longitude 经度 string
  name 组织名称 string
  parentOrgId 父级组织ID integer(int64)
  specialCode 第三方编码 integer(int64)
  type 组织类型（集团(GROUP)、公司(COMPANY)、部门(DEPARTMENT)、区域(暂时不可用)..） string
message string
successful boolean

响应示例:

{
    "code": 0,
    "data": [
        {
            "alias": "",
            "code": "",
            "description": "",
            "enabled": false,
            "functionType": "",
            "id": 0,
            "latitude": "",
            "leader": 0,
            "longitude": "",
            "name": "",
            "parentOrgId": 0,
            "type": ""
        }，
        {...}
    ],
    "message": "",
    "successful": true
}
作者：admin  创建时间：2021-07-06 11:18
最后编辑：wanglejiang  更新时间：2026-01-29 21:48