調用BatchSendMail批量發送郵件。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
AccountName | String | 是 | test@example.com | 管理控制臺中配置的發信地址。 |
AddressType | Integer | 是 | 1 |
|
ReceiversName | String | 是 | test2 | 預先創建且上傳了收件人的收件人列表名稱,注意:收信人列表需要在觸發任務之后至少10分鐘后再刪除,否則容易引起發信失敗 |
TemplateName | String | 是 | test1 | 預先創建且通過審核的模板名稱。 |
Action | String | 否 | BatchSendMail | 系統規定參數。取值:BatchSendMail。 |
ClickTrace | String | 否 | 0 |
|
TagName | String | 否 | test3 | 郵件標簽名稱。 |
ReplyAddress | String | 否 | test2***@example.net | 回信地址 |
ReplyAddressAlias | String | 否 | 小紅 | 回信地址別稱 |
UnSubscribeLinkType | String | 否 | default | 生成的退訂鏈接類型。參照退訂功能幫助說明文檔
"google", "aol.com", "hotmail", "outlook", "ymail.com"等
|
UnSubscribeFilterLevel | String | 否 | mailfrom_domain | 過濾級別。參照退訂功能幫助說明文檔
|
返回數據
名稱 | 類型 | 示例值 | 描述 |
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. | 回信地址格式不正確,必須有@符號,域名組成為數字,字母,下劃線,減號和點,賬號組成為數字,字母,下劃線,減號和點 |
訪問錯誤中心查看更多錯誤碼。