すべてのプロダクト
Search
ドキュメントセンター

:GetUserIdByUserExternalId

最終更新日:Mar 30, 2026

外部 ID に基づいて、Employee Identity and Access Management (EIAM) アカウントの ID を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /v2/{instanceId}/{applicationId}/users/_/actions/getUserIdByExternalId HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

instanceId

string

必須

インスタンスの ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

applicationId

string

必須

アプリケーションの ID。

app_mkv7rgt4d7i4u7zqtzev2mxxxx

リクエストパラメーター

パラメーター

必須 / 任意

説明

Authorization

string

必須

認証情報。形式: Bearer ${access_token}。例: Bearer ATxxxx。

Bearer AT8csE2seYxxxxxij

body

object

任意

リクエストボディ。

userExternalId

string

必須

アカウントの外部 ID。

xxx001

userSourceType

string

必須

アカウントのソースタイプ。有効な値:

  • build_in: アカウントは Identity as a Service (IDaaS) で作成されました。

  • ding_talk: アカウントは DingTalk からインポートされました。

  • ad: アカウントは Microsoft Active Directory (AD) からインポートされました。

  • ldap: アカウントは Lightweight Directory Access Protocol (LDAP) サービスからインポートされました。

build_in

userSourceId

string

必須

アカウントのソース ID。アカウントが IDaaS で作成された場合、そのソース ID は IDaaS インスタンスの ID です。アカウントがインポートされた場合、そのソース ID はソース内の企業 ID です。例えば、アカウントが DingTalk からインポートされた場合、そのソース ID は DingTalk 内の企業の corpId 値です。

idaas_ue2jvisn35ea5lmthk267xxxxx

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

userId

string

アカウントの ID。

user_d6sbsuumeta4h66ec3il7yxxxx

成功レスポンス

JSONJSON

{
  "userId": "user_d6sbsuumeta4h66ec3il7yxxxx"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。