GenAuth DocsDocuments
Concepts
User Guide
Development Integration
AgentAuth
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Concepts
User Guide
Development Integration
AgentAuth
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Old version
  • Single Page Web Application

  • Mobile and Client Applications

  • Standard Web Application

    • Java

      • Installation and Usage
      • User Authentication Module
      • Management Module

        • User Management

        • Group Management

        • Role Management

        • Organization Management

          • Get Top-level Organization List
          • Create Top-level Organization
          • Modify Top-level Organization
          • Delete Organization
          • Search Top-level Organization List
          • Get Department Information
          • Create Department
          • Modify Department
          • Delete Department
          • Search Departments
          • Get Sub-department List
          • Get Department Member List
          • Get Department Direct Member ID List
          • Search Department Members
          • Add Department Members
          • Remove Department Members
          • Get Parent Department Information
          • Check if User is in Department
        • Access Control Management

        • External Identity Source Management

        • Custom Field Management

    • Node.js

    • Python

  • Framework Integration

  • Others

  1. Development Integration
  2. /
  3. Standard Web Application
  4. /
  5. Java
  6. /
  7. Management Module

  8. /
  9. Organization Management

  10. /
  11. Create Top-level Organization

¶ 创建顶层组织机构

Update time: 2025-07-23 07:34:21
Edit

创建组织机构,会创建一个只有一个节点的组织机构,可以选择组织描述信息、根节点自定义 ID、多语言等。

¶ 请求参数

名称类型必填默认值描述示例值
organizationNamestring是-组织名称。蒸汽记忆
organizationCodestring是-组织 code。steamory
descriptionstring否-组织描述信息。组织描述信息
openDepartmentIdstring否-根节点自定义 ID。60b49eb83fd80adb96f26e68
i18nOrganizationNameI18nDto否-多语言设置。{"organizationName":{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}}

¶ 示例代码

import cn.authing.sdk.java.dto.*;
import cn.authing.sdk.java.client.ManagementClient;
import cn.authing.sdk.java.model.ManagementClientOptions;

class ManagementClientTest {
    private static String ACCESS_KEY_ID = "GEN_AUTH_USERPOOL_ID";
    private static String ACCESS_KEY_SECRET = "GEN_AUTH_USERPOOL_SECRET";

    public static void main(String[] args) {
        ManagementClientOptions clientOptions = new ManagementClientOptions(ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        ManagementClient managementClient = new ManagementClient(clientOptions);

        CreateOrganizationReqDto request = new CreateOrganizationReqDto();
        request.setOrganizationCode("steamory");
        request.setOrganizationName("蒸汽记忆");
        request.setDescription("组织描述信息");
        request.setOpenDepartmentId("60b49eb83fd80adb96f26e68");
            I18n= new OrganizationNameI18nDto(
                        OrganizationName= new LangObject(
                        Zh-CN= new LangUnit(
                    request.setEnabled(false);
    request.setValue(false);
        ),
        En-US= new LangUnit(
                    request.setEnabled(false);
    request.setValue(false);
        ),
        ),
        ),

        OrganizationSingleRespDto response = managementClient.createOrganization(request);
        System.out.println(response);
    }
}

¶ 请求响应

类型: OrganizationSingleRespDto

名称类型描述
statusCodenumber业务状态码,可以通过此状态码判断操作是否成功,200 表示成功。
messagestring描述信息
apiCodenumber细分错误码,可通过此错误码得到具体的错误类型。
dataOrganizationDto响应数据

示例结果:

{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "organizationCode": "steamory",
    "organizationName": "蒸汽记忆",
    "description": "组织描述信息",
    "departmentId": "60b49eb83fd80adb96f26e68",
    "openDepartmentId": "60b49eb83fd80adb96f26e68",
    "hasChildren": true,
    "leaderUserIds": "[\"60b49eb83fd80adb96f26e68\"]",
    "membersCount": 150,
    "i18n": {
      "organizationName": {
        "zh-CN": {
          "enabled": false,
          "value": "中文"
        },
        "en-US": {
          "enabled": false,
          "value": "English"
        }
      }
    }
  }
}

¶ 数据结构

¶ OrganizationNameI18nDto

名称类型必填描述
organizationName是支持多语言的字段。嵌套类型:LangObject。 示例值: [object Object]

¶ LangObject

名称类型必填描述
zh-CN是多语言的中文内容。嵌套类型:LangUnit。 示例值: [object Object]
en-US是多语言的英文内容。嵌套类型:LangUnit。 示例值: [object Object]

¶ LangUnit

名称类型必填描述
enabledboolean是是否已开启。若开启,且控制台选择该语言,则展示该内容。(默认关闭)。
valueboolean是多语言内容。

¶ OrganizationDto

名称类型必填描述
organizationCodestring是组织 code。 示例值: steamory
organizationNamestring是组织名称。 示例值: 蒸汽记忆
descriptionstring否组织描述信息。 示例值: 组织描述信息
departmentIdstring是根节点 ID。 示例值: 60b49eb83fd80adb96f26e68
openDepartmentIdstring否根节点自定义 ID。 示例值: 60b49eb83fd80adb96f26e68
hasChildrenboolean是是否包含子节点。 示例值: true
leaderUserIdsarray否部门负责人 ID。 示例值: ["60b49eb83fd80adb96f26e68"]
membersCountnumber是部门人数。 示例值: 150
isVirtualNodeboolean是是否是虚拟部门。
i18n否多语言设置。嵌套类型:OrganizationNameI18nDto。 示例值: [object Object]

¶ OrganizationNameI18nDto

名称类型必填描述
organizationName是支持多语言的字段。嵌套类型:LangObject。 示例值: [object Object]

¶ LangObject

名称类型必填描述
zh-CN是多语言的中文内容。嵌套类型:LangUnit。 示例值: [object Object]
en-US是多语言的英文内容。嵌套类型:LangUnit。 示例值: [object Object]

¶ LangUnit

名称类型必填描述
enabledboolean是是否已开启。若开启,且控制台选择该语言,则展示该内容。(默认关闭)。
valueboolean是多语言内容。
Previous article: Get Top-level Organization List Next article: Modify Top-level Organization
  • 请求参数
  • 示例代码
  • 请求响应
  • 数据结构

User identity management

Integrated third-party login
Customized authentication process

Enterprise internal management

Single sign-on
Multi-factor authentication
Permission management

Developer

Development Documentation
GitHub (opens new window)

Company

official@genauth.ai
16th Floor, Building B, Beichen Century Center, Chaoyang District, Beijing (Total)
Room 406, 4th Floor, Block B, No. 200, Tianfu Fifth Street, High-tech Zone, Chengdu (Branch)

© Beijing Steamory Technology Co., Ltd.