名稱

類型

是否必選

示例值

描述

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

在郵件推送控制臺創建的標簽，用于分類所發送的郵件批次，可以通過標簽來查詢每批郵件的發送情況，另外如果開啟郵件跟蹤功能，發信必須使用郵件標簽。

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

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個字符。