動的にインスタンスURLを取得！Apex活用の基本ガイド

SalesforceインスタンスURLの取得方法

SalesforceインスタンスURLは、API連携や外部システムとの統合において重要な情報です。このURLを正確に取得する方法は、Apexコードや組み込み関数を使用することで簡単に実現できます。

---

ApexでのインスタンスURLの取得

Apexを使用して現在のSalesforceインスタンスURLを取得するには、URL.getOrgDomainUrl() または URL.getSalesforceBaseUrl() メソッドを使用します。以下はその具体例です。

例1: 組織のインスタンスURLを取得

// 現在の組織のインスタンスURLを取得
String instanceUrl = URL.getOrgDomainUrl().toExternalForm();
System.debug('Instance URL: ' + instanceUrl);

---

例2: 現在のコンテキストからインスタンスURLを構築する

System.Url.getCurrentRequestUrl()を使用すると、現在のリクエストのURLを取得できます。このURLからインスタンス部分を抽出することが可能です。

例:

 String currentUrl = URL.getCurrentRequestUrl().toExternalForm();
 String instanceUrl = currentUrl.substringBefore('/services');
 System.debug('Instance URL: ' + instanceUrl);

---

インスタンスURLが必要な主なユースケース

1. API連携:
   RESTやSOAP APIを使用してデータを操作する際に、インスタンスURLがエンドポイントとして使用されます。

2. 外部システムとの統合:
   外部アプリケーションがSalesforceデータにアクセスする場合、正しいインスタンスURLが必要です。

3. VisualforceページやLightning Web Component:
   URLを動的に生成する必要がある場合にインスタンスURLを使用します。

---

注意点

1. インスタンスURLの変更:
   インスタンスURLは、組織のメンテナンスやリロケーションにより変更される場合があります。そのため、可能であれば動的に取得することが推奨されます。

2. Sandbox環境:
   サンドボックス環境ではURLが異なるため、環境に応じて正しいURLを取得してください。