如何調用SingleSendMail發送單條郵件 -

本文介紹如何調用SingleSendMail發送單條郵件，SingleSendMail不支援發送附件。

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
AccountName	String	是	test***@example.net	管理主控台中配置的發信地址。
AddressType	Integer	是	1	地址類型。取值： 0：為隨機帳號 1：為發信地址
ReplyToAddress	String	是	true	是否啟用管理主控台中配置好回信地址（狀態須驗證通過），取值範圍是字串true或者false（不是bool值）。
Subject	String	是	Subject	郵件主題，長度不大於100個字元。
ToAddress	String	是	test1***@example.net	目標地址，多個 email 地址可以用逗號分隔，最多100個地址（支援郵件組）。
Action	String	否	SingleSendMail	系統規定參數。取值：SingleSendMail。
ClickTrace	String	否	0	1：為開啟資料跟蹤功能 0（預設）：為關閉資料跟蹤功能。
FromAlias	String	否	小紅	發信人暱稱，長度小於15個字元。例如：發信人暱稱設定為”小紅”，發信地址為 test*@example.net，收信人看到的發信地址為“小紅”<test*@example.net>。
HtmlBody	String	否	body	郵件 html 本文，SDK限制80K。注意：HtmlBody和TextBody是針對不同類型的郵件內容，兩者必須傳其一。
TagName	String	否	test	在Direct Mail控制台建立的標籤，用於分類所發送的郵件批次，可以通過標籤來查詢每批郵件的發送情況，另外如果開啟郵件跟蹤功能，發信必須使用郵件標籤。
TextBody	String	否	body	郵件 text 本文，SDK限制80K。注意：HtmlBody和TextBody是針對不同類型的郵件內容，兩者必須傳其一。
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	xxxxxx	事件ID
RequestId	String	2D086F6-8F31-4658-84C1-006DED011A85	請求ID

樣本

請求樣本

https://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test***@example.net&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1***@example.net&<公用請求參數>

正常返回樣本

XML 格式

<SingleSendMailResponse>      <EnvId>xxxxxx</EnvId>      <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>

JSON 格式

{    “EnvId”:”xxxxxx”,    “RequestId”:”12D086F6-8F31-4658-84C1-006DED011A85”}

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	InvalidReceiverName.Malformed	The specified receiver name is wrongly formed.	收件者格式不正確，必須有@符號，網域名稱組成為數字，字母，底線，減號和點，帳號組成為數字，字母，底線，減號和點。
404	InvalidMailAddress.NotFound	The specified mail address is not found.	發信地址未找到。
404	InvalidReceiver.NotFound	The specified receiver is invalid.	收件者不存在，請檢查收件者是否存在。
400	InvalidToAddress	The specified toAddress is wrongly formed.	收件者格式不正確，必須有@符號，網域名稱組成為數字，字母，底線，減號和點，帳號組成為數字，字母，底線，減號和點。
400	InvalidToAddress.Spam	Sendmail rejected by invalid address.	無效地址，請檢查地址有效性。
400	InvalidBody	The specified textBody or htmlBody is wrongly formed.	textBody或textBody格式錯誤,請重新填寫內容。
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	InvalidSubject.Malformed	The specified subject is invalid. It must not exceed 100 characters.	主題錯誤，主題不能超過100個字元。
400	InvalidFromAlias.Malformed	The specified fromAlias is wrongly formed.	發信人別名格式錯誤，長度不超過15個符。
400	InvalidReplyAddressAlias.Malformed	The specified replyAddressAlias is wrongly formed.	回信地址別名格式不正確，長度不超過15個符。
400	InvalidReplyAddress.Malformed	The specified replyAddress is wrongly formed.	回信地址格式不正確，必須有@符號，網域名稱組成為數字，字母，底線，減號和點，帳號組成為數字，字母，底線，減號和點。
404	InvalidIP.NotFound	The specified IP address is invalid.	指定的IP無效。若您開啟了IP防護，請確保IP地址在列表中。
400	InvalidFromALias.Malformed	The specified fromAlias is wrongly formed.	寄件者暱稱不正確。檢查寄件者暱稱，該暱稱必須少於15個字元。

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