GetOrganizationalUnitIdByExternalId - 通过组织外部ID获取组织ID

更新时间:
复制为 MD 格式

调用GetOrganizationalUnitIdByExternalId接口,通过组织外部ID获取组织内部ID。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/{instanceId}/{applicationId}/organizationalUnits/_/actions/getOrganizationalUnitIdByExternalId HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

instanceId

string

实例 ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

applicationId

string

应用 ID。

app_mkv7rgt4d7i4u7zqtzev2mxxxx

请求参数

名称

类型

必填

描述

示例值

Authorization

string

认证信息。 格式:Bearer ${access_token}。 示例:Bearer ATxxxx。

Bearer AT8csE2seYxxxxxij

body

object

请求 body。

xxx001

organizationalUnitExternalId

string

组织外部 ID,用于外部数据与 IDaaS 组织的数据关联映射,默认为 IDaaS 组织 ID。

说明:外部 ID 在同一来源类型和来源 ID 下唯一。

ou_wovwffm62xifdziem7an7xxxxx

organizationalUnitSourceType

string

组织来源类型,取值可选范围:

  • build_in:自建。

  • ding_talk:钉钉导入。

  • ad:AD 导入。

  • ldap:LDAP 导入。

build_in

organizationalUnitSourceId

string

组织来源 ID。

自建类型默认为实例 ID,其他类型,分别对应不同来源的企业 ID,比如钉钉来源对应钉钉企业的 corpId。

idaas_ue2jvisn35ea5lmthk267xxxxx

返回参数

名称

类型

描述

示例值

object

OrganizationalUnitIdObject

organizationalUnitId

string

组织 ID。

ou_wovwffm62xifdziem7an7xxxxx

示例

正常返回示例

JSON格式

{
  "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情