SingleSendMail_发送邮件相关接口_API 参考

描述

SingleSendMail 接口为单一发信接口。

请求参数

名称	类型	是否必须	描述
Action	String	必须	操作接口名，系统规定参数，取值：SingleSendMail。
AccountName	String	必须	管理控制台中配置的发信地址。
ReplyToAddress	Boolean	必须	使用管理控制台中配置的回信地址（状态必须是验证通过）。
AddressType	Number	必须	取值范围 0~1: 0 为随机账号；1 为发信地址。
ToAddress	String	必须	目标地址，多个 email 地址可以用逗号分隔，最多100个地址。
FromAlias	String	可选	发信人昵称,长度小于 15 个字符。例如:发信人昵称设置为”小红”，发信地址为 “test@example.com”，收信人看到的发信地址为`"小红"<test@example.com>`。
Subject	String	可选	邮件主题，建议填写。
TagName	String	可选	标签
HtmlBody	String	可选	邮件 html 正文，限制28K。
TextBody	String	可选	邮件 text 正文，限制28K。
ClickTrace	String	可选	取值范围 0~1: 1 为打开数据跟踪功能; 0 为关闭数据跟踪功能。该参数默认值为 0。

其他请求参数，请参见公共请求参数。

返回参数

参数	描述	语义
EnvId		事件ID

其他公共返回参数，请参见公共返回参数。

错误码

错误代码	描述	Http 状态码	语义
InvalidMailAddress.NotFound	The specified mailAddress does not exist.	400	发信地址不存在。
InvalidMailAddressStatus.Malformed	The specified mailAddress status is wrongly formed.	400	发信地址状态不正确。
InvalidToAddress	The specified toAddress is wrongly formed.	400	目标地址不正确。
InvalidBody	The specified textBody or htmlBody is wrongly formed.	400	邮件正文不正确。textBody 或 htmlBody 不能同时为空。
InvalidSendMail.Spam	Sendmail rejected by spam filter.	400	本次发送操作被反垃圾系统检测为垃圾邮件，禁止发送。请仔细检查邮件内容和域名状态等。
InvalidSubject.Malformed	The specified subject is wrongly formed.	400	邮件主题限制在 100 个字符以内。
InvalidMailAddressDomain.Malformed	The specified mailAddress domain does not exist.	400	发信地址的域名状态不正确，请检查 MX、SPF 配置是否正确。
InvalidFromALias.Malformed	The specified fromAlias is wrongly formed.	400	发信人昵称不正确，请检查发信人昵称是否正确，长度应小于 15 个字符。
InvalidToAddress.Spam	Sendmail rejected by invalid address.	400	收件地址因无效而拒绝，请检查收件地址是否真实有效。

示例

请求示例

https://dm.aliyuncs.com/?Action=SingleSendMail
&AccountName=test@example.com
&ReplyToAddress=true
&AddressType=1   
&ToAddress=test1@example.com
&Subject=Subject
&HtmlBody=body
&<公共请求参数>

返回示例

XML格式

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

JSON示例

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