本トピックでは、Direct Mail SDK のインストール方法と使用方法について説明します。
OpenAPI を使用して、Direct Mail の API 操作の呼び出し、クエリ、デバッグを行い、サンプルコードを生成できます。
基本的な手順は次のとおりです:
OpenAPI デバッグページへの移動
次の例では、API 操作を使用してメールを送信する方法を示します:
メールの送信 (デバッグとサンプルコードの表示)
単一メールを送信する場合:
デバッグエントリポイントとサンプルコード:
https://api.alibabacloud.com/api/Dm/2015-11-23/SingleSendMail
ループ呼び出しと同時呼び出しがサポートされています。
1 回のリクエストで最大 100 件の受信元アドレスをサポートします。その他のパラメーターの詳細については、「SingleSendMail」をご参照ください。
一括でメールを送信する場合:
デバッグエントリポイントとサンプルコード:
https://api.alibabacloud.com/api/Dm/2015-11-23/BatchSendMail
コンソールで作成した、または API を呼び出して作成したテンプレートと受信者リストを使用して、一括でメールを送信できます。その他のパラメーターの詳細については、「BatchSendMail」をご参照ください。
API 操作のクエリとパラメーターの指定
デフォルトの API バージョン 2015-11-23 の使用を推奨します。このバージョンは、バージョン名が変更されることなく、継続的な最適化と更新が行われます。

詳細については、API ドキュメントをご参照ください。

プログラミング言語の選択とデバッグ
プログラミング言語を選択し、[呼び出しの実行] をクリックします。

呼び出しのサンプルコードの生成
方法1:Direct Mail SDK の使用
SDK インストールコマンドの取得
テストが正常に完了したら、ローカルマシンまたはテストサーバーに SDK をインストールします。
「SDK 情報」セクションで、Direct Mail SDK のバージョンとインストールコマンドを確認できます。


方法2:CommonRequest の使用
「共通モード」に切り替えてサンプルコードを生成します。このモードでは、パラメーターはデフォルトで URL ではなくリクエストボディで渡されるため、URL が長すぎることによるリクエストのブロックを防ぐことができます。

C# の例:
C# SDK を使用して長いコンテンツを送信する際に「Invalid URI: The Uri string is too long」エラーが発生する
関連ドキュメント
Java 汎用呼び出し 1.0 (非推奨)
その他の考慮事項
AccessKey の作成
Alibaba Cloud アカウントでログインした後、デバッグページでキーを指定する必要はありません。ただし、ローカルマシンまたはサーバーでコードを実行するには、コード内でキーを設定する必要があります。
(注:代わりに、Resource Access Management (RAM) サービスの AccessKey を使用することもできます。)
AccessKey 管理コンソールにログインします。
ページの右上隅にある [AccessKey の作成] をクリックします。「作成」ダイアログボックスが開きます。
プロンプトを読み、[OK] をクリックします。
情報漏洩を防ぐため、コードに `accessKeyId` と `accessKeySecret` の値をハードコーディングしないでください。
オペレーティングシステムで `ALIBABA_CLOUD_ACCESS_KEY_ID` と `ALIBABA_CLOUD_ACCESS_KEY_SECRET` の値を環境変数として設定できます。Alibaba Cloud SDK は、これらの値を環境変数から取得して ID 検証を行います。詳細については、「ID 検証の設定」をご参照ください。