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

  7. Management Module

  8. /

  9. Organization Management

  10. /
  11. Create Department

创建部门

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

通过组织 code、部门名称、父部门 ID，创建部门，可以设置多种参数。

请求参数

名称类型必填默认值描述示例值
parentDepartmentIdstring是-父部门 id。6229c4deb3e4d8a20b6021ff
namestring是-部门名称。开发部
organizationCodestring是-组织 Code（organizationCode）。steamory
openDepartmentIdstring否-自定义部门 ID，用于存储自定义的 ID。ou_7dab8a3d3cdccxxxxxx777c7ad535d62
descriptionstring否-部门描述。技术研发部门
codestring否-部门识别码。6229c4deb3e4d8a20b6021ff
isVirtualNodeboolean否-是否是虚拟部门。
i18nI18nDto否-多语言设置。{"name":{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}}
customDataobject否-部门的扩展字段数据。{"icon":"https://example.com/logo"}
departmentIdTypestring否department_id此次调用中使用的父部门 ID 的类型。 枚举值：department_id,open_department_iddepartment_id

示例代码

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);

        CreateDepartmentReqDto request = new CreateDepartmentReqDto();
        request.setOrganizationCode("steamory");
        request.setOpenDepartmentId("ou_7dab8a3d3cdccxxxxxx777c7ad535d62");
        request.setName("开发部");
        request.setDescription("技术研发部门");
        request.setParentDepartmentId("6229c4deb3e4d8a20b6021ff");
        request.setCode("6229c4deb3e4d8a20b6021ff");
        request.setIsVirtualNode(false);
            I18n= new I18nDto(
                        Name= new LangObject(
                        Zh-CN= new LangUnit(
                    request.setEnabled(false);
    request.setValue(false);
        ),
        En-US= new LangUnit(
                    request.setEnabled(false);
    request.setValue(false);
        ),
        ),
        ),
        request.setCustomData(new CreateDepartmentReqDto.setIcon("https://example.com/logo",));
        request.setDepartmentIdType(CreateDepartmentReqDto.departmentIdType.DEPARTMENT_ID);

        DepartmentSingleRespDto response = managementClient.createDepartment(request);
        System.out.println(response);
    }
}

请求响应

类型： DepartmentSingleRespDto

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

示例结果：

{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "organizationCode": "steamory",
    "departmentId": "60b49eb83fd80adb96f26e68",
    "createdAt": "2022-07-03T02:20:30.000Z",
    "openDepartmentId": "ou_7dab8a3d3cdccxxxxxx777c7ad535d62",
    "name": "开发部",
    "leaderUserIds": "[\"60b49eb83fd80adb96f26e68\"]",
    "description": "技术研发部门",
    "parentDepartmentId": "6229c4deb3e4d8a20b6021ff",
    "code": "6229c4deb3e4d8a20b6021ff",
    "membersCount": 11,
    "hasChildren": true,
    "i18n": {
      "name": {
        "zh-CN": {
          "enabled": false,
          "value": "中文"
        },
        "en-US": {
          "enabled": false,
          "value": "English"
        }
      }
    },
    "customData": {
      "icon": "https://example.com/logo"
    }
  }
}

数据结构

I18nDto

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

LangObject

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

LangUnit

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

DepartmentDto

名称类型必填描述
organizationCodestring是组织 Code（organizationCode）。 示例值： steamory
departmentIdstring是部门系统 ID（为 GenAuth 系统自动生成，不可修改）。 示例值： 60b49eb83fd80adb96f26e68
createdAtstring是部门创建时间。 示例值： 2022-07-03T02:20:30.000Z
openDepartmentIdstring否自定义部门 ID，用于存储自定义的 ID。 示例值： ou_7dab8a3d3cdccxxxxxx777c7ad535d62
namestring是部门名称。 示例值： 开发部
leaderUserIdsarray否部门负责人 ID。 示例值： ["60b49eb83fd80adb96f26e68"]
descriptionstring否部门描述。 示例值： 技术研发部门
parentDepartmentIdstring是父部门 id。 示例值： 6229c4deb3e4d8a20b6021ff
codestring否部门识别码。 示例值： 6229c4deb3e4d8a20b6021ff
membersCountnumber是部门人数（仅包含直属成员）。 示例值： 11
hasChildrenboolean是是否包含子部门。 示例值： true
isVirtualNodeboolean否是否是虚拟部门。
i18n否多语言设置。嵌套类型：I18nDto。 示例值： [object Object]
customDataobject否部门的扩展字段数据。 示例值： [object Object]

I18nDto

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

LangObject

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

LangUnit

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