HTTP API経由でメールを送信する

HTTP API は、プログラムで電子メールを送信するために推奨される方法です。柔軟な JSON またはマルチパートペイロード (API バージョンに応じて) を備えた REST インターフェイスを提供するため、ほとんどの統合に適しています。

NTT CPaaS over HTTPを使用してメールを送信するには、以下の手順に従ってください。各ステップは、選択した API バージョンに関係なく適用されます。

各ステップの詳細については、以下のセクションを参照してください。

メール API エンドポイントを選択する

NTT CPaaSは、メール送信用のAPIを2つ提供しています。

詳細については、「電子メールメッセージの送信 (opens in a new tab) API エンドポイント」を参照してください。

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

例：

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

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

ベース URL の詳細については、製品ドキュメントおよび API ドキュメント (opens in a new tab)をご覧ください。

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

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

API 認証 の詳細については、製品ドキュメントおよび API ドキュメント (opens in a new tab)をご覧ください。

スコープの割り当てに関するガイダンスについては、API スコープを参照してください。

HTTP リクエストを作成するときは、次のコンポーネントを含めます。

API URL: ベース URL を選択したエンドポイントと組み合わせます。例: https://{base_url}/email/3/send
権限付与: 選択した認証方法を使用して「権限付与」ヘッダーを含めます。使用する資格情報またはトークンに必要なスコープが含まれていることを確認します。
コンテンツタイプ: 使用しているメール API バージョンに応じてヘッダーを設定します。
- v3 → multipart/form-data
- v4 → application/json
本文: 要求本文は、必須フィールドとオプションフィールドで構成されます。
- 必須フィールドには通常、次のものが含まれます。
  - 差し出し人
  - 受賞者
  - 件名
  - メールの内容
- オプションのフィールドには、次のものが含まれます。
  - 添付ファイル
  - カスタムヘッダー
  - トラッキングオプション
  - テンプレート
  - パーソナライゼーションフィールド
  - 追加のメタデータ

各エンドポイントのドキュメントには、次のものが含まれます。