调用SingleSendMail发送单条邮件。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
AccountName String test@example.com

管理控制台中配置的发信地址。

AddressType Integer 1

地址类型。取值:

  • 0:为随机账号
  • 1:为发信地址
ReplyToAddress Boolean true

使用管理控制台中配置的回信地址(状态必须是验证通过)。

Subject String Subject

邮件主题,建议填写。

ToAddress String test1@example.com

目标地址,多个 email 地址可以用逗号分隔,最多100个地址。

AccessKeyId String your_accesskey_id

您的AccessKey ID。

Action String SingleSendMail

系统规定参数。取值:SingleSendMail

ClickTrace String 0
  • 1:为打开数据跟踪功能
  • 0(默认):为关闭数据跟踪功能。
FromAlias String 小明

发信人昵称,长度小于15个字符。

例如:发信人昵称设置为”小红”,发信地址为 test@example.com,收信人看到的发信地址为"小红"<test@example.com>

HtmlBody String body

邮件 html 正文,限制28K。

ReplyAddress String 111@aliyun.com

回信地址。

ReplyAddressAlias String 回信地址别称

回信地址别称

TagName String test

标签

TextBody String 12121

邮件 text 正文,限制28K。

返回数据

名称 类型 示例值 描述
EnvId String xxxxxx

事件ID

RequestId String 2D086F6-8F31-4658-84C1-006DED011A85

请求ID

示例

请求示例


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

正常返回示例

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. 收件人格式不正确,必须有@符号,域名组成为数字,字母,下划线,减号和点,账号组成为数字,字母,下划线,减号和点
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 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 wrongly formed. 主题错误,主题不能超过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. 回信地址格式不正确,必须有@符号,域名组成为数字,字母,下划线,减号和点,账号组成为数字,字母,下划线,减号和点

访问错误中心查看更多错误码。