Authing 文档文档
快速开始
概念
使用指南
开发集成 arrow
  • V2 文档
  • V3 文档
元数据
应用集成
身份自动化
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
快速开始
概念
使用指南
开发集成 arrow
  • V2 文档
  • V3 文档
元数据
应用集成
身份自动化
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
旧版
  • 单页 Web 应用

  • 移动、客户端应用

  • 标准 Web 应用

    • C#

    • Go

    • Java

      • 安装使用
      • 用户认证模块
      • 管理模块

        • 用户管理

        • 分组管理

        • 角色管理

        • 组织机构管理

          • 获取顶层组织机构列表
          • 创建顶层组织机构
          • 修改顶层组织机构
          • 删除组织机构
          • 搜索顶层组织机构列表
          • 获取部门信息
          • 创建部门
          • 修改部门
          • 删除部门
          • 搜索部门
          • 获取子部门列表
          • 获取部门成员列表
          • 获取部门直属成员 ID 列表
          • 搜索部门下的成员
          • 部门下添加成员
          • 部门下删除成员
          • 获取父部门信息
          • 判断用户是否在某个部门下
        • 访问控制管理

        • 外部身份源管理

        • 自定义字段管理

    • Node.js

    • PHP

    • Python

  • 框架集成

  • 其他

  1. 开发集成
  2. /
  3. 标准 Web 应用
  4. /
  5. Java
  6. /
  7. 管理模块

  8. /
  9. 组织机构管理

  10. /
  11. 创建顶层组织机构

¶ 创建顶层组织机构

更新时间: 2025-02-18 09:00:47
编辑

创建组织机构,会创建一个只有一个节点的组织机构,可以选择组织描述信息、根节点自定义 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 = "AUTHING_USERPOOL_ID";
    private static String ACCESS_KEY_SECRET = "AUTHING_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是多语言内容。
上一篇: 获取顶层组织机构列表 下一篇: 修改顶层组织机构
  • 请求参数
  • 示例代码
  • 请求响应
  • 数据结构

用户身份管理

集成第三方登录
手机号闪验 (opens new window)
通用登录表单组件
自定义认证流程

企业内部管理

单点登录
多因素认证
权限管理

开发者

开发文档
框架集成
博客 (opens new window)
GitHub (opens new window)
社区用户中心 (opens new window)

公司

400 888 2106
sales@authing.cn
北京市朝阳区北辰世纪中心 B 座 16 层(总)
成都市高新区天府五街 200 号 1 号楼 B 区 4 楼 406 室(分)

京ICP备19051205号

beian京公网安备 11010802035968号

© 北京蒸汽记忆科技有限公司