API 標準および多言語対応の SDK
本製品 (Dm/2015-11-23) の API は、RPC 標準に準拠した OpenAPI 仕様を採用しています。Alibaba Cloud には主要なプログラミング言語に対応した SDK が用意され、リクエスト署名のような手間がかかる手順を省略できます。そのため、開発者は HTTP 通信の詳細を意識することなく、各言語の構文で API を呼び出すことが可能になります。
カスタム署名
署名のカスタマイズが必要な場合、「署名メカニズム」を参照してリクエストに手動で署名できます。手動署名プロセスは非常に煩雑で、通常はおよそ 5 営業日かかります。詳細については、DingTalk サポート窓口 (グループチャット ID：147535001692) までお問い合わせください。
はじめに
Alibaba Cloud アカウント (root ユーザー) は最高レベルの管理権限を持ち、その AccessKey ペアが悪用されると、関連するすべてのリソースが不正にアクセスされ、重大なセキュリティリスクを引き起こす可能性があります。そのため、必要な場合以外は、Alibaba Cloud アカウントを使用しないでください。その代わりに、API のみでのアクセスを許可された Resource Access Management (RAM) ユーザーを作成し、RAM ポリシーを設定することで、最小権限の原則 (PoLP) を徹底してください。
API セキュリティを確保するには、以下を作成し、設定する必要があります。
RAM ユーザー
RAM ユーザー用の AccessKey ペア
アカウント
|
API |
タイトル |
説明 |
| DescAccountSummary | Get Account Information | アカウント情報を取得します。 |
| UpdateUser | Update user information | アカウント情報を更新します。 |
| GetUser | Get User Information | アカウント詳細を取得します |
ホワイトリスト
|
API |
タイトル |
説明 |
| AddIpfilter | Add IP Whitelist | IP 保護情報を追加します。 |
| DeleteIpfilterByEdmId | Delete IP Whitelist | IP 保護情報を削除します。 |
IP 保護
|
API |
タイトル |
説明 |
| UpdateIpProtection | Enable or Disable IP Protection Function | IP 保護を更新する API |
| GetIpProtection | Check if IP Protection is Enabled | IP 保護情報を取得します。 |
| GetIpfilterList | Get IP Filter List | IP 保護情報を取得します |
タスク
|
API |
タイトル |
説明 |
| QueryTaskByParam | Query Task | 指定されたパラメーターに基づいてタスクを照会します。 |
メール
|
API |
タイトル |
説明 |
| 統計 | 統計 | |
| SenderStatisticsByTagNameAndBatchID | 指定された条件に基づいて送信データを取得します。 | 指定された条件に一致する送信統計情報を取得します。 |
| SenderStatisticsDetailByParam | Get Sending Details | 送信詳細を照会します。 |
| GetTrackList | 送信済みメールトラッキングデータの取得 | メール追跡は、送信済みメールに関するデータを取得します。 |
| GetTrackListByMailFromAndTagName | 送信元アドレスとラベル別にメールトラッキングの送信データを取得する | 指定された条件を満たすメールトラッキングデータを取得します。 |
| SingleSendMail | Send a Single Email | 単一のメールを送信します。 |
| BatchSendMail | メールをバッチ送信します | メールをバッチ送信します。 |
| SendTestByTemplate | Send Test Email | テンプレートを使用してテストメールを送信します。 |
ドメイン
|
API |
タイトル |
説明 |
| CreateDomain | Create Domain | ドメインを作成します。 |
| DeleteDomain | Delete Domain | ドメインの削除 |
| ModifyPWByDomain | Set the SMTP password for a domain | ドメインレベルのパスワードを変更します。 |
| QueryDomainByParam | Query Domain List Information | ドメイン情報を照会します。 |
| CheckDomain | Verify Domain | ドメインステータスを確認します。 |
| DescDomain | Configure Domain | ドメイン名を設定します。 |
アドレス
|
API |
タイトル |
説明 |
| CreateMailAddress | Create Mail Address | メールアドレスを作成します。 |
| DeleteMailAddress | Delete Mail Address | メールアドレスを削除します。 |
| ModifyMailAddress | Set SMTP Password and Reply Address for Sending Address | 送信元アドレスを変更します。 |
| QueryInvalidAddress | Get Invalid Address Information | NextStart を文字列に変更 |
| QueryMailAddressByParam | 送信者アドレスリストのクエリ | 送信元アドレスのリストを照会します。 |
| ApproveReplyMailAddress | Verify Reply Address | 返信元メールアドレスの検証 |
| CheckReplyToMailAddress | Verify Reply-To Address for Sending Emails | 返信先アドレスの検証 |
| DeleteInvalidAddress | Delete Invalid Address | 無効なアドレスデータベースから無効なアドレスを削除します。 |
受信者
|
API |
タイトル |
説明 |
| CreateReceiver | Create Receiver List | 受信者リストを作成します。 |
| DeleteReceiver | Delete Receiver List | 受信者リストを削除します。 |
| DeleteReceiverDetail | Delete a Single Recipient | 個別の受信者を削除します |
| QueryReceiverByParam | Query Recipient List | 受信者リストを取得します。 |
| QueryReceiverDetail | Query Details of a Specific Recipient List | 受信者リストの詳細情報を取得します |
| SaveReceiverDetail | Create a Single Recipient | 単一の受信者を作成します。 |
タグ
|
API |
タイトル |
説明 |
| CreateTag | Create Tag | タグを作成します。 |
| DeleteTag | Delete Tag | タグを削除します。 |
| ModifyTag | Modify Tag | タグを変更します。 |
| QueryTagByParam | Retrieve Tags | QueryTagByParam を呼び出してタグを取得します。 |
専用 IP
|
API |
タイトル |
説明 |
| DedicatedIpPoolCreate | Create IP Pool | 専用 IP プールを作成します。 |
| DedicatedIpPoolDelete | DedicatedIpPoolDelete | 専用 IP プールを削除します。 |
| DedicatedIpPoolUpdate | Update IP Pool | IP プールを更新します。 |
| DedicatedIpPoolList | List IP Pools | IP プールをリスト表示します。 |
| DedicatedIpNonePoolList | List IPs Not Added to IP Pool | どの IP プールにも割り当てられていない IP アドレスを一覧表示します。この操作は、IP プールの構成に使用されます。 |
| DedicatedIpAutoRenewal | Set IP Auto Renewal | 専用 IP アドレスの自動更新を設定します。 |
| DedicatedIpChangeWarmupType | Update Purchased IP Warmup Method | 専用 IP アドレスのプリフェッチメソッドを更新します。 |
| DedicatedIpList | List Purchased IP Addresses | 購入済みの専用 IP アドレスの一覧を表示します。 |
無効なアドレス
|
API |
タイトル |
説明 |
| ListUserSuppression | List Personal and System Invalid Addresses | ユーザーの無効なアドレスを一覧表示します。 |
| CreateUserSuppression | Create Invalid Address or Domain | ユーザーの無効なアドレスを作成します |
| RemoveUserSuppression | Remove Invalid Addresses for Individuals and Systems | ユーザーレベルのサプレッションリストから、システムが識別したアドレスと手動で追加したアドレスを削除します。 |
| UnblockSending | Lift Sending Restrictions | サブスクライブ解除または苦情によって発生した送信制限を解除します。 |
| ListBlockSending | ListBlockSending | メール送信ブラックリストをクエリします。 |
構成セット
|
API |
タイトル |
説明 |
| ConfigSetCreate | ConfigSetCreate | 構成セットを作成します。最大 100 個の構成セットを作成できます。 |
| ConfigSetDelete | ConfigSetDelete | 構成セットを削除します。 |
| ConfigSetUpdate | ConfigSetUpdate | 構成セットを更新します。 |
| ConfigSetDetail | ConfigSetDetail | 指定された構成セットの詳細を取得します。 |
| ConfigSetList | ConfigSetList | ConfigSet を一覧表示します。 |
| ConfigSetRelationFromAddress | ConfigSetRelationFromAddress | 構成セットを送信元アドレスに関連付けます。 |
| ConfigSetCancelRelationFromAddress | ConfigSetCancelRelationFromAddress | 送信元アドレスと構成セットの関連付けを解除します。 |
テンプレート
|
API |
タイトル |
説明 |
| CreateTemplate | CreateTemplate | DirectMail で新しいメールテンプレートを作成します。 |
| DescTemplate | テンプレート情報を表示します | テンプレート情報を照会します。 |
| QueryTemplateByParam | テンプレートリストをページごとに照会します | テンプレートリスト情報をページごとに照会します。 |
アドレス検証
|
API |
タイトル |
説明 |
| GetValidationQuota | GetValidationQuota | メール検証クォータを取得します。 |
| ValidateEmail | ValidateEmail | メールアドレスを検証します。 |
| SendValidateFile | SendValidateFile | 検証対象のアドレスリストをアップロードできます。 |
| GetValidateFileStatus | GetValidateFileStatus | ファイル検証タスクのステータスを取得します。 |
| GetValidateFile | GetValidateFile | バッチ検証タスクの結果ファイルを取得します。 |
| DeleteValidateFile | DeleteValidateFile | 検証プロセスが完了した後、検証ファイルを削除します。 |
その他
|
API |
タイトル |
説明 |
| ListValidateFile | ListValidateFile | アップロードされた検証ファイルのリストを取得します。 |
Others
|
API |
タイトル |
説明 |
| DeleteTemplate | テンプレートを削除します | テンプレート情報を照会します。 |
| ModifyTemplate | メールテンプレートを変更します | メールテンプレートを変更します。 |