# ApexでSalesforce外部システムと連携するHTTP Calloutの基本

## 目次

1. はじめに
2. HTTP Calloutとは
3. SalesforceでのHTTP Calloutの活用例
4. HTTP Calloutの基本構成
5. HTTPリクエストの作成
6. HTTPレスポンスの処理
7. HTTP Calloutにおける制限と注意点
8. レートリミットと再試行の設計
9. セキュリティ: 認証と承認
10. 開発中のデバッグとロギング
11. まとめ

## 1. はじめに

Salesforceを他のシステムと連携させたいと考える企業や開発者は多いです。その中で、外部システムとの情報のやり取りを実現する手段として有効なのがHTTP Calloutです。本記事では、Apexを用いてどのようにHTTP Calloutを実装するのか、その基本的な考え方と実装手順について解説します。

## 2. HTTP Calloutとは

HTTP Calloutは、Salesforce内のApexコードから外部のWebサービスと通信するための機能です。これは特に、データ連携や外部APIの利用が必要なケースでよく使われます。

## 3. SalesforceでのHTTP Calloutの活用例

- **データの統合**: 顧客データを外部CRMと同期。
- **通知システム**: 商品の発注状況を外部システムへ通知。
- **リアルタイムデータ取得**: 外部の天気情報を取得してアプリ内で表示。

## 4. HTTP Calloutの基本構成

1. **HTTPリクエスト作成**: 対象のURL、HTTPメソッド、ヘッダー情報などを設定。
2. **HTTP送信**: 作成したリクエストを外部システムへ送信。
3. **HTTPレスポンス処理**: 戻ってきたデータを解析し、必要な処理を実行。

### ApexでのHTTPリクエストの基本構成

![img](/mosaic-code.jpg)

## 5. HTTPリクエストの作成

リクエストを作成する際に必要な情報は主に以下です。

- **エンドポイントURL**: 接続先のAPIのURL
- **HTTPメソッド**: GET, POST, PUT, DELETEなど
- **ヘッダー設定**: 認証情報やコンテンツタイプ
- **ボディ**: POSTやPUTの場合は送信データが必要

### 実装例: POSTリクエスト

![img](/mosaic-code.jpg)

## 6. HTTPレスポンスの処理

HTTPレスポンスでは外部システムからの応答が返されます。通常はステータスコードとボディから成ります。

- **ステータスコード**: リクエストの結果（200台は成功、400台はクライアントエラー、500台はサーバエラー）
- **レスポンスボディ**: 取得したデータ

### レスポンス処理例

![img](/mosaic-code.jpg)

## 7. HTTP Calloutにおける制限と注意点

SalesforceにはHTTP Calloutに関するいくつかの制限事項があります。

- **最大同時コールアウト数**: 1つのApexトランザクションで最大100のコールアウトが可能。
- **総実行時間**: コールアウトの合計実行時間は120秒以内であること。

## 8. レートリミットと再試行の設計

外部システムは通常、レートリミットを設けており、一定以上のリクエストが連続すると制限をかけるようになっています。

- **再試行ロジック**: レートリミットでブロックされた場合の再試行処理。
- **適切な待機時間**: 指定された時間以上待つことで回避。

## 9. セキュリティ: 認証と承認

外部システムと連携する際は、認証が必須です。通常はOAuthトークンを使用します。

- **OAuth流れ**: アクセストークンの発行、リフレッシュトークンの使用。
- **セキュアな保存方法**: Salesforceのセキュリティ機能を利用して管理。

## 10. 開発中のデバッグとロギング

開発中や障害時のトラブルシューティングには、デバッグとログの分析が重要です。

- **デバッグログの活用**: Salesforceの標準機能を使いHTTPリクエストとレスポンスを記録。
- **エラーハンドリングの強化**: try-catch構文を使い、例外ハンドリングを徹底。

## 11. まとめ

HTTP CalloutはSalesforceを外部システムと連携させるための強力な手法です。この記事で紹介した基本的な構成とステップを参考に、実際に実装してみましょう。設計時には制限やセキュリティを考慮することが重要です。上記の内容を理解し、SalesforceのHTTP Calloutを効果的に活用することで、システム連携の経験をより豊かに積むことができるでしょう。 [cv:issue_marketplace_engineer]

# ApexでSalesforce外部システムと連携するHTTP Calloutの基本

## 目次

1. はじめに
2. HTTP Calloutとは
3. SalesforceでのHTTP Calloutの活用例
4. HTTP Calloutの基本構成
5. HTTPリクエストの作成
6. HTTPレスポンスの処理
7. HTTP Calloutにおける制限と注意点
8. レートリミットと再試行の設計
9. セキュリティ: 認証と承認
10. 開発中のデバッグとロギング
11. まとめ

## 1. はじめに

Salesforceを他のシステムと連携させたいと考える企業や開発者は多いです。その中で、外部システムとの情報のやり取りを実現する手段として有効なのがHTTP Calloutです。本記事では、Apexを用いてどのようにHTTP Calloutを実装するのか、その基本的な考え方と実装手順について解説します。

## 2. HTTP Calloutとは

HTTP Calloutは、Salesforce内のApexコードから外部のWebサービスと通信するための機能です。これは特に、データ連携や外部APIの利用が必要なケースでよく使われます。

## 3. SalesforceでのHTTP Calloutの活用例

- **データの統合**: 顧客データを外部CRMと同期。
- **通知システム**: 商品の発注状況を外部システムへ通知。
- **リアルタイムデータ取得**: 外部の天気情報を取得してアプリ内で表示。

## 4. HTTP Calloutの基本構成

1. **HTTPリクエスト作成**: 対象のURL、HTTPメソッド、ヘッダー情報などを設定。
2. **HTTP送信**: 作成したリクエストを外部システムへ送信。
3. **HTTPレスポンス処理**: 戻ってきたデータを解析し、必要な処理を実行。

### ApexでのHTTPリクエストの基本構成

```apex
Http http = new Http();
HttpRequest request = new HttpRequest();
request.setEndpoint('https://api.example.com/data');
request.setMethod('GET');
HttpResponse response = http.send(request);
```

## 5. HTTPリクエストの作成

リクエストを作成する際に必要な情報は主に以下です。

- **エンドポイントURL**: 接続先のAPIのURL
- **HTTPメソッド**: GET, POST, PUT, DELETEなど
- **ヘッダー設定**: 認証情報やコンテンツタイプ
- **ボディ**: POSTやPUTの場合は送信データが必要

### 実装例: POSTリクエスト

```apex
request.setEndpoint('https://api.example.com/resource');
request.setMethod('POST');
request.setHeader('Content-Type', 'application/json');
String jsonBody = '{"key":"value"}';
request.setBody(jsonBody);
```

## 6. HTTPレスポンスの処理

HTTPレスポンスでは外部システムからの応答が返されます。通常はステータスコードとボディから成ります。

- **ステータスコード**: リクエストの結果（200台は成功、400台はクライアントエラー、500台はサーバエラー）
- **レスポンスボディ**: 取得したデータ

### レスポンス処理例

```apex
Integer statusCode = response.getStatusCode();
if (statusCode == 200) {
    String responseBody = response.getBody();
    Map<String, Object> results = (Map<String, Object>) JSON.deserializeUntyped(responseBody);
    // 結果を処理
} else {
    // エラー処理
}
```

## 7. HTTP Calloutにおける制限と注意点

SalesforceにはHTTP Calloutに関するいくつかの制限事項があります。

- **最大同時コールアウト数**: 1つのApexトランザクションで最大100のコールアウトが可能。
- **総実行時間**: コールアウトの合計実行時間は120秒以内であること。

## 8. レートリミットと再試行の設計

外部システムは通常、レートリミットを設けており、一定以上のリクエストが連続すると制限をかけるようになっています。

- **再試行ロジック**: レートリミットでブロックされた場合の再試行処理。
- **適切な待機時間**: 指定された時間以上待つことで回避。

## 9. セキュリティ: 認証と承認

外部システムと連携する際は、認証が必須です。通常はOAuthトークンを使用します。

- **OAuth流れ**: アクセストークンの発行、リフレッシュトークンの使用。
- **セキュアな保存方法**: Salesforceのセキュリティ機能を利用して管理。

## 10. 開発中のデバッグとロギング

開発中や障害時のトラブルシューティングには、デバッグとログの分析が重要です。

- **デバッグログの活用**: Salesforceの標準機能を使いHTTPリクエストとレスポンスを記録。
- **エラーハンドリングの強化**: try-catch構文を使い、例外ハンドリングを徹底。

## 11. まとめ

HTTP CalloutはSalesforceを外部システムと連携させるための強力な手法です。この記事で紹介した基本的な構成とステップを参考に、実際に実装してみましょう。設計時には制限やセキュリティを考慮することが重要です。上記の内容を理解し、SalesforceのHTTP Calloutを効果的に活用することで、システム連携の経験をより豊かに積むことができるでしょう。 

ApexでSalesforce外部システムと連携するHTTP Calloutの基本

目次

続きを読むには単価診断を受けてください（30秒）