全部产品
Search
文档中心

邮件推送:SingleSendMail

更新时间:Feb 21, 2024

本文介绍如何调用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

邮件主题,建议填写。

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

在邮件推送控制台创建的标签,用于分类所发送的邮件批次,可以通过标签来查询每批邮件的发送情况,另外如果开启邮件跟踪功能,发信必须使用邮件标签。

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

示例

请求示例

http(s)://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 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.

回信地址格式不正确,必须有@符号,域名组成为数字,字母,下划线,减号和点,账号组成为数字,字母,下划线,减号和点。

404

InvalidIP.NotFound

The specified IP address is invalid.

指定的IP无效。若您开启了IP防护,请确保IP地址在列表中。

400

InvalidFromALias.Malformed

The specified fromAlias is wrongly formed.

发件人昵称不正确。检查发件人昵称,该昵称必须少于15个字符。

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