HTTP API経由のメール送信

HTTP API は、プログラムでメールを送信する方法として推奨されています。このAPIは、柔軟なJSONまたはマルチパートのペイロード (APIのバージョンによって異なります) に対応するRESTインターフェースを使用するため、ほぼすべてのシステム連携に適しています。

NTT CPaaSからメールをHTTP経由で送信するには、以下の手順に従います。各ステップは、選択するAPIのバージョンに関係なく適用されます：

各ステップの詳細については、以下のビデオと該当セクションをご参照ください。

メールAPIエンドポイントの選択

NTT CPaaSでは、メール送信用に2つのAPIバージョンを提供しています：

詳細については、フル機能メールの送信用APIのエンドポイントについて詳述しているドキュメントをご参照ください。

詳細については、メールメッセージの送信用APIのエンドポイントについて詳述しているドキュメントをご参照ください。

NTT CPaaSアカウントには、どのAPIリクエストでも必ず使用する必要がある一意のベースURLが含まれています。

例：

https://{base_url}/email/3/send

ベースURLを表示するには、お持ちのNTT CPaaS資格情報を使って NTT CPaaS APIリソースハブにログインします。ログインすると、すべてのページにxxxxx.api.infobip.comの形式でベースURLが表示されます。

もっと詳しく知る

Learn more about the Base URL in our product documentation and in the API documentation.

すべてのメールAPIリクエストには、Authorizationヘッダーが必要です。NTT CPaaSでは、複数の認証方式をサポートしています。

認証情報またはトークンには、次のスコープの少なくとも1つが含まれている必要があります:

もっと詳しく知る

Learn more about API authorization in our product documentation and in the API documentation.

スコープの割り当てに関するガイダンスについては、APIスコープについて詳述しているドキュメントをご参照ください。

HTTPリクエストを作成する時は、次のコンポーネントを含めるようにします：

API URL: ベースURLを選択したエンドポイントと組み合わせます。例： https://{base_url}/email/3/send
Authorization：選択した認証方式を使用してAuthorization ヘッダーを含めます。使用する認証情報またはトークンに必要なスコープが含まれていることを確認します。
Content-type：使用するメールAPIのバージョンに応じてヘッダーを設定します。
- v3 → multipart/form-data
- v4 → application/json
本文：リクエスト本文は、必須フィールドと任意フィールドで構成されます。
- 必須フィールド には通常、次のものが含まれます：
  - 送信者
  - 受信者
  - 件名
  - メールのコンテンツ
- 任意フィールド としては、以下が含まれる場合があります：
  - 添付ファイル
  - カスタムヘッダー
  - 追跡オプション
  - テンプレート
  - パーソナライゼーション用のフィールド
  - 追加のメタデータ

各エンドポイントについて詳述しているドキュメントには、以下の項目が含まれています：