全部產品
Search
文件中心

:BatchSendMail

更新時間:Jul 13, 2024

調用BatchSendMail批量發送郵件。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱

類型

是否必選

樣本值

描述

AccountName

String

test@example.com

管理主控台中配置的發信地址。

AddressType

Integer

1

  • 0:為隨機帳號

  • 1:為發信地址

ReceiversName

String

test2

預先建立且上傳了收件者的收件者清單名稱,注意:收信人列表需要在觸發任務之後至少10分鐘後再刪除,否則容易引起發信失敗

TemplateName

String

test1

預先建立且通過審核的模板名稱。

Action

String

BatchSendMail

系統規定參數。取值:BatchSendMail

ClickTrace

String

0

  • 1:為開啟資料跟蹤功能

  • 0(預設):為關閉資料跟蹤功能

TagName

String

test3

郵件標籤名稱。

ReplyAddress

String

test2***@example.net

回信地址

ReplyAddressAlias

String

小紅

回信地址別稱

UnSubscribeLinkType

String

default

產生的退訂連結類型。參照退訂功能協助說明文檔

  • disabled: 不產生

  • default: 採用預設策略:對批量類型的發信地址發給特定網域名稱時會產生退訂連結,如帶有關鍵字"gmail", "yahoo",

"google", "aol.com", "hotmail",

"outlook", "ymail.com"等

  • zh-cn: 產生,給將來埋點到內容準備

  • en-us: 產生,給將來埋點到內容準備

UnSubscribeFilterLevel

String

mailfrom_domain

過濾層級。參照退訂功能協助說明文檔

  • disabled: 不過濾

  • default: 採用預設策略,批量地址採用發信地址層級過濾

  • mailfrom: 發信地址層級過濾

  • mailfrom_domain: 發信網域名稱層級過濾

  • edm_id: 帳號層級過濾

返回資料

名稱

類型

樣本值

描述

EnvId

String

xxx

事件ID

RequestId

String

12D086F6-8F31-4658-84C1-006DED011A85

請求ID

樣本

請求樣本

https://dm.aliyuncs.com/?Action=BatchSendMail
&AccountName=test@example.com
&AddressType=1
&ReceiversName=test2
&TemplateName=test1
&<公用請求參數>

正常返回樣本

XML 格式

<BatchSendMailResponse>
      <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
      <EnvId>xxx</EnvId>
</BatchSendMailResponse>

JSON 格式

{
        "EnvId":"xxx",
        "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"
}

錯誤碼

HttpCode

錯誤碼

錯誤資訊

描述

400

InvalidMailAddressName.Malformed

The specified MailAddress name is wrongly formed.

發信地址格式不正確,必須有@符號,網域名稱組成為數字,字母,底線,減號和點,帳號組成為數字,字母,底線,減號和點

400

InvalidReceiverName.Malformed

The specified receiver name is wrongly formed.

收件者格式不正確,必須有@符號,網域名稱組成為數字,字母,底線,減號和點,帳號組成為數字,字母,底線,減號和點

400

InvalidTemplateName.Malformed

The specified template name is wrongly formed.

模板名格式不正確,模板名不能大於30個字元

404

InvalidMailAddress.NotFound

The specified mailAddress does not exist.

不存在,請檢查批定的發信地址。

404

InvalidTemplate.NotFound

The specified template does not exist.

指定的模板不存在。

404

InvalidReceiver.NotFound

The specified receiver does not exist.

收件者不存在,請檢查收件者是否存在

400

InvalidSendMail.Spam

Sendmail rejected by spam filter.

發信被拒絕,請檢查使用者狀態,是否是頻率超限,額度等問題

400

InvalidMailAddressSendType.Malformed

The specified mailAddress sendType is wrongly formed.

發送類型不正確,請去控制台檢查類型,設定相應的值

400

InvalidMailAddressStatus.Malformed

The specified mailAddress status is wrongly formed.

發信地址狀態不對,請檢查是否可用,是否是被凍結狀態

400

InvalidMailAddressDomain.Malformed

The specified mailAddress domain does not exist.

網域名稱格式不正確,請使用數字,字母,底線,減號和點

400

InvalidTemplateStatus.Malformed

The specified template status is wrongly formed.

模板狀態不正確,請檢查模板是否已通過審核

400

InvalidReceiverStatus.Malformed

The specified receivers status is wrongly formed.

收件者狀態不正確,請去控制台檢查是否已上傳收件者

400

InvalidReplyAddressAlias.Malformed

The specified replyAddressAlias is wrongly formed.

回信地址別名格式不正確,長度不超過15個符

400

InvalidReplyAddress.Malformed

The specified replyAddress is wrongly formed.

回信地址格式不正確,必須有@符號,網域名稱組成為數字,字母,底線,減號和點,帳號組成為數字,字母,底線,減號和點

訪問錯誤中心查看更多錯誤碼。