邮件推送：SingleSendMail - 发送单条邮件

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

地址类型。取值：

0：为随机账号

1：为发信地址

在邮件推送控制台创建的标签，用于分类所发送的邮件批次，可以通过标签来查询每批邮件的发送情况，另外如果开启邮件跟踪功能，发信必须使用邮件标签。 长度为 1-128 个字符，允许英文字母、数字、_、-

是否启用管理控制台中配置好回信地址（状态须验证通过），取值范围是字符串 true 或者 false。

目标地址，多个 email 地址可以用逗号分隔，最多 100 个地址（支持邮件组）。

邮件主题，长度不大于 256 个字符。

邮件 html 正文。

注意：HtmlBody 和 TextBody 是针对不同类型的邮件内容，两者必须传其一。

• URL 传参限制约 80KB

• 新版 SDK 采用 Body 传参限制约 8MB（ java 1.4.0 及以上， python3 1.4.0 及以上， php 1.4.0 及以上 ）

邮件 text 正文。

注意：HtmlBody 和 TextBody 是针对不同类型的邮件内容，两者必须传其一。

• URL 传参限制约 80KB

• 新版 SDK 采用 Body 传参限制约 8MB（ java 1.4.0 及以上， python3 1.4.0 及以上， php 1.4.0 及以上 ）

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

例如：发信人昵称设置为”小红”，发信地址为 test***@example.net，收信人看到的发信地址为“小红”test***@example.net。

回信地址

回信地址昵称

1：为打开数据跟踪功能

0（默认）：为关闭数据跟踪功能。

disabled: 不生成

default: 采用默认策略：对批量类型的发信地址发给特定域名时会生成退订链接，如带有关键字"gmail", "yahoo",

"google", "aol.com", "hotmail",

"outlook", "ymail.com"等，具体参照退订功能生成链接和过滤机制文档

显示语言根据收件人的浏览器设置自动识别

过滤级别。参照退订功能生成链接和过滤机制文档

disabled: 不过滤

default: 采用默认策略，批量地址采用发信地址级别过滤

mailfrom: 发信地址级别过滤

mailfrom_domain: 发信域名级别过滤

edm_id: 账号级别过滤

邮件头设置

标准字段和非标准字段都需要符合标准中对头的语法要求，API 发信最多可通过 headers 字段传入 10 个标头，超出限制会被忽略，SMTP 没有限制。

1、标准字段

Message-ID，List-Unsubscribe，List-Unsubscribe-Post

标准字段会覆盖掉邮件头中原有的值。

2、非标准字段

不区分大小写

a、以 X-User- 开头（不推送到事件总线 EB、消息服务 MNS。仅 API 要求，SMTP 任意自定义）

b、以 X-User-Notify- 开头（推送到事件总线 EB、消息服务 MNS。API 和 SMTP 都支持）

推动到 EB 或 MNS 时，header 字段下会包含这些字段

独立 IP 地址池 ID。购买了独立 IP 的用户可以通过这个参数指定本次发信出口 IP。 参照独立 IP文档。

• 指定邮件的密送收件人列表。

• 系统会将与主邮件内容一致的副本分别发送至每个密送地址，但密送信息对所有收件人（含 ToAddress、BccAddress）均不可见。

• 为了保护密送收件人的隐私，发送给密送收件人的邮件将默认不开启任何邮件追踪功能。 这意味着，对于密送邮件，系统不会记录打开率、点击率等行为数据。但发送量的计费、和发送详情、和发送状态的统计与正常邮件一致。

• 每次发送最多可指定 2 个密送收件人。

启用域级别认证

• true

• false

仅在域级别认证时使用，发信地址级别认证请忽略。

1、domain-auth-created-by-system@example.com 控制台创建这个地址，@前缀保持固定不变，后缀用自己域名。

2、

API 场景

AccountName 填域名，收件人看到的发件人是 domain-auth-created-by-system@example.com。

SMTP 场景

a.通过 ModifyPWByDomain 接口设置域名密码。

b.使用域名和设置的密码认证，真实发件人 mailfrom 传自定义的地址，如 user@example.com，收件人看到的发件人是 user@example.com。