すべてのプロダクト
Search
ドキュメントセンター

Direct Mail:SDK ガイド

最終更新日:May 28, 2026

OpenAPI Explorer を使用して Direct Mail API オペレーションを呼び出し、デバッグし、SDK サンプルコードを生成します。

OpenAPI Explorer を使用して、Direct Mail API オペレーションの検索、デバッグ、サンプルコードの生成を行います。

基本的な手順:

1. OpenAPI Explorer ページへのアクセス

例:Eメールの送信

Eメールの送信 (デバッグとサンプルコードの確認)

単一 Eメールの送信:

デバッグとサンプルコードの確認:

https://api.alibabacloud.com/api/Dm/2015-11-23/SingleSendMail

説明

ループ呼び出しと同時呼び出しがサポートされています。

1 つのリクエストで最大 100 件の受信者アドレスがサポートされます。その他のパラメータについては、SingleSendMail をご参照ください。

一括 Eメールの送信:

デバッグとサンプルコードの確認:

https://api.alibabacloud.com/api/Dm/2015-11-23/BatchSendMail

説明

コンソールまたは API で作成したテンプレートと受信者リストを使用して一括 Eメールを送信します。その他のパラメータについては、BatchSendMail をご参照ください。

2. API オペレーションの検索とパラメータの指定

デフォルトの API バージョン 2015-11-23 を使用します。バージョン識別子は変わりませんが、API オペレーションは継続的に更新されます。

image

API オペレーションのドキュメントを表示します。

image

3. デバッグ用のプログラミング言語の選択

プログラミング言語を選択し、[呼び出しの開始] をクリックします。

image

4. サンプルコードの生成

方法 1:Direct Mail SDK の使用

SDK インストールコマンドの取得

テストが成功したら、ローカルマシンまたはサーバーに SDK をインストールします。

[SDK Info] セクションに SDK バージョンとインストールコマンドが表示されます。

image

image

方法 2:CommonRequest の使用

[Generate code in Common mode] に切り替えます。URL の長さの制限を回避するため、デフォルトではパラメータはリクエストボディで渡されます。

image

C# の例:

C# SDK を使用して長いコンテンツを送信する際の "Invalid URI: The Uri string is too long" エラー

参照:

Java 汎化呼び出し 1.0 (非推奨予定)

Java 汎化呼び出し 2.0

よくある質問

AccessKey の作成方法

Alibaba Cloud アカウントにログインしている場合、デバッグページではキーは不要です。ただし、ローカルまたはサーバーへのデプロイメントでは、コードにキーを設定する必要があります。

RAM で作成した AccessKey ペアを使用することもできます。

  1. AccessKey 管理コンソールにログインします。

  2. 右上隅の [Create AccessKey] をクリックします。

  3. プロンプトを読み、[OK] をクリックします。

警告

漏えいを防ぐため、コード内に "accessKeyId" と "accessKeySecret" の値をハードコードしないでください。

Alibaba Cloud SDK は、ID 検証用の環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID と ALIBABA_CLOUD_ACCESS_KEY_SECRET をサポートしています。詳細については、「ID 検証の設定」をご参照ください。

SignatureDoesNotMatch エラー

SignatureDoesNotMatch

Message: Specified signature is not matched with our calculation.

1. 自己署名メカニズムを使用している場合は、パラメータの順序とエンコーディングが正しいことを確認してください。署名プロセスを簡略化するには、Direct Mail SDK を使用してください。

2. AccessKey シークレットが正しくないか確認してください。

AccessKey ID が正しくない場合のエラーメッセージ: Specified access key is not found.

AccessKey シークレットが正しくない場合のエラーメッセージ: Specified signature is not matched with our calculation.

3. システム時刻の差を確認してください。

システム時刻がサーバー時刻と 15 分以上ずれていないことを確認してください。

システムが別のタイムゾーンにある場合は、UTC+8 と同期してください。

システム時刻を確認するコマンド

Windows:

echo %date% %time%
tzutil /g

Mac:

date
systemsetup -gettimezone