Skip to main content

概述

向单个收件人发送一封事务性邮件。您可以提供原始 HTML 内容或引用已保存的模板,使用动态标签个性化邮件,提前最多 72 小时安排投递,跟踪打开和点击,以及附加文件,所有操作在一次请求中完成。 基础 URL: https://api.effilink.co 端点: POST /v5/transactional/mail/sends_customised 认证方式: 在请求header中添加ApiKey来进行认证

请求参数

string
必填
邮件主题。
string
HTML 邮件正文内容。如果未提供 templateName,则此字段为必填。
string
已保存模板的名称。当同时提供 contenttemplateName 时,优先使用模板。
object
键值对,用于填充 content 或模板中格式为 {{tagName}} 的个性化标签。
string
必填
已验证的发件人邮箱地址。使用前必须在您的 EffiLink 账户中完成注册。
string
收件人收件箱中显示的发件人名称。最大 200 字节
string
回复邮箱地址。收件人的回复将发送到此地址,而不是 senderMail
string
定时发送时间,采用 ISO 8601 UTC 格式(例如 2024-03-10T12:00:00Z)。最多可提前 72 小时 安排。省略此字段则立即发送。
object
必填
此邮件的单个收件人。
string
邮件分类标签,用于组织和报表。最大 100 字节。仅限字母数字字符。
string
用于在分析中分组邮件的营销活动名称。最大 100 字节。仅限字母数字字符。
int
设置为 1 以启用此邮件的打开跟踪。
int
设置为 1 以启用链接点击跟踪。若要排除某个链接不被跟踪,请在其 anchor 标签上添加 ef:disable-tracking 属性。
string
用于跟踪和去重的唯一消息标识符。最大 50 字节
object
要附加到邮件的单个文件。每次请求仅支持一个附件。
boolean
设置为 true 进行测试发送。API 会正常验证和处理请求,但不会实际投递邮件。

响应字段

int
成功时为 200。失败值请参见错误代码
string
成功时为空字符串("")。失败时包含错误描述。

错误代码


示例

请求

响应