SingleSendMail
本文介紹如何調(diào)用SingleSendMail發(fā)送單條郵件,SingleSendMail不支持發(fā)送附件。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
AccountName | String | 是 | test***@example.net | 管理控制臺(tái)中配置的發(fā)信地址。 |
AddressType | Integer | 是 | 1 | 地址類型。取值:
|
ReplyToAddress | String | 是 | true | 是否啟用管理控制臺(tái)中配置好回信地址(狀態(tài)須驗(yàn)證通過(guò)),取值范圍是字符串true或者false(不是bool值)。 |
Subject | String | 是 | Subject | 郵件主題,長(zhǎng)度不大于100個(gè)字符。 |
ToAddress | String | 是 | test1***@example.net | 目標(biāo)地址,多個(gè) email 地址可以用逗號(hào)分隔,最多100個(gè)地址(支持郵件組)。 |
Action | String | 否 | SingleSendMail | 系統(tǒng)規(guī)定參數(shù)。取值:SingleSendMail。 |
ClickTrace | String | 否 | 0 |
|
FromAlias | String | 否 | 小紅 | 發(fā)信人昵稱,長(zhǎng)度小于15個(gè)字符。 例如:發(fā)信人昵稱設(shè)置為”小紅”,發(fā)信地址為 test***@example.net,收信人看到的發(fā)信地址為“小紅”<test***@example.net>。 |
HtmlBody | String | 否 | body | 郵件 html 正文,SDK限制80K。注意:HtmlBody和TextBody是針對(duì)不同類型的郵件內(nèi)容,兩者必須傳其一。 |
TagName | String | 否 | test | 在郵件推送控制臺(tái)創(chuàng)建的標(biāo)簽,用于分類所發(fā)送的郵件批次,可以通過(guò)標(biāo)簽來(lái)查詢每批郵件的發(fā)送情況,另外如果開(kāi)啟郵件跟蹤功能,發(fā)信必須使用郵件標(biāo)簽。 |
TextBody | String | 否 | body | 郵件 text 正文,SDK限制80K。注意:HtmlBody和TextBody是針對(duì)不同類型的郵件內(nèi)容,兩者必須傳其一。 |
ReplyAddress | String | 否 | test2***@example.net | 回信地址 |
ReplyAddressAlias | String | 否 | 小紅 | 回信地址昵稱 |
UnSubscribeLinkType | String | 否 | default | 生成的退訂鏈接類型。參照退訂功能幫助說(shuō)明文檔
"google", "aol.com", "hotmail", "outlook", "ymail.com"等
|
UnSubscribeFilterLevel | String | 否 | mailfrom_domain | 過(guò)濾級(jí)別。參照退訂功能幫助說(shuō)明文檔
|
返回?cái)?shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
EnvId | String | xxxxxx | 事件ID |
RequestId | String | 2D086F6-8F31-4658-84C1-006DED011A85 | 請(qǐng)求ID |
示例
請(qǐng)求示例
https://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test***@example.net&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1***@example.net&<公共請(qǐng)求參數(shù)>
正常返回示例
XML
格式
<SingleSendMailResponse> <EnvId>xxxxxx</EnvId> <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>
JSON
格式
{ “EnvId”:”xxxxxx”, “RequestId”:”12D086F6-8F31-4658-84C1-006DED011A85”}
錯(cuò)誤碼
HttpCode | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
400 | InvalidReceiverName.Malformed | The specified receiver name is wrongly formed. | 收件人格式不正確,必須有@符號(hào),域名組成為數(shù)字,字母,下劃線,減號(hào)和點(diǎn),賬號(hào)組成為數(shù)字,字母,下劃線,減號(hào)和點(diǎn)。 |
404 | InvalidMailAddress.NotFound | The specified mail address is not found. | 發(fā)信地址未找到。 |
404 | InvalidReceiver.NotFound | The specified receiver is invalid. | 收件人不存在,請(qǐng)檢查收件人是否存在。 |
400 | InvalidToAddress | The specified toAddress is wrongly formed. | 收件人格式不正確,必須有@符號(hào),域名組成為數(shù)字,字母,下劃線,減號(hào)和點(diǎn),賬號(hào)組成為數(shù)字,字母,下劃線,減號(hào)和點(diǎn)。 |
400 | InvalidToAddress.Spam | Sendmail rejected by invalid address. | 無(wú)效地址,請(qǐng)檢查地址有效性。 |
400 | InvalidBody | The specified textBody or htmlBody is wrongly formed. | textBody或textBody格式錯(cuò)誤,請(qǐng)重新填寫內(nèi)容。 |
400 | InvalidSendMail.Spam | Sendmail rejected by spam filter. | 發(fā)信被拒絕,請(qǐng)檢查用戶狀態(tài),是否是頻率超限,額度等問(wèn)題。 |
400 | InvalidMailAddressSendType.Malformed | The specified mailAddress sendType is wrongly formed. | 發(fā)送類型不正確,請(qǐng)去控制臺(tái)檢查類型,設(shè)置相應(yīng)的值。 |
400 | InvalidMailAddressStatus.Malformed | The specified mailAddress status is wrongly formed. | 發(fā)信地址狀態(tài)不對(duì),請(qǐng)檢查是否可用,是否是被凍結(jié)狀態(tài)。 |
400 | InvalidMailAddressDomain.Malformed | The specified mailAddress domain does not exist. | 域名格式不正確,請(qǐng)使用數(shù)字,字母,下劃線,減號(hào)和點(diǎn)。 |
400 | InvalidSubject.Malformed | The specified subject is invalid. It must not exceed 100 characters. | 主題錯(cuò)誤,主題不能超過(guò)100個(gè)字符。 |
400 | InvalidFromAlias.Malformed | The specified fromAlias is wrongly formed. | 發(fā)信人別名格式錯(cuò)誤,長(zhǎng)度不超過(guò)15個(gè)符。 |
400 | InvalidReplyAddressAlias.Malformed | The specified replyAddressAlias is wrongly formed. | 回信地址別名格式不正確,長(zhǎng)度不超過(guò)15個(gè)符。 |
400 | InvalidReplyAddress.Malformed | The specified replyAddress is wrongly formed. | 回信地址格式不正確,必須有@符號(hào),域名組成為數(shù)字,字母,下劃線,減號(hào)和點(diǎn),賬號(hào)組成為數(shù)字,字母,下劃線,減號(hào)和點(diǎn)。 |
404 | InvalidIP.NotFound | The specified IP address is invalid. | 指定的IP無(wú)效。若您開(kāi)啟了IP防護(hù),請(qǐng)確保IP地址在列表中。 |
400 | InvalidFromALias.Malformed | The specified fromAlias is wrongly formed. | 發(fā)件人昵稱不正確。檢查發(fā)件人昵稱,該昵稱必須少于15個(gè)字符。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。