通过 SMTP 发送邮件

更新时间：2026-07-03 09:00

使用 SMTP 中继，从您的电子邮件客户端或应用程序发送事务性电子邮件(订单确认、密码重置、帐户创建通知和其他自动消息)。

连接设置

1. 访问地址(Endpoint)，根据您所在地域选择就近节点：
   

2. 端口：非加密端口：1026、1027； 加密端口(SSL or TLS)：4026、4027。
3. 用户名：任意字符串(建议使用您 EffiLink 帐户的主要联系邮箱)。
4. 密码：任何有效的 EffiLink API 密钥(如何申请api key)。

配置 SMTP 标头(SMTP headers)

您可以使用 SMTP 标头自定义邮件，添加跟踪打开、点击，定义邮件类别或指定 EffiLink 应用于邮件的选项，支持下面3个参数：X-Easeye-API、X-Easeye-UniqueMsgID、X-Easeye-ExpirationDate。

X-Easeye-API
本Header的值是一段 JSON 字符串，用以传递发送的选项。支持的功能和相应的配置值如下：

1. category： 邮件类别（例如注册邮件-Registration）；最大长度100个byte，字符范围是大小写字母和阿拉伯数字；
   
2. campaign：邮件任务名称；最大长度100个byte，字符范围是大小写字母和阿拉伯数字；
   
3. send_options：
   track_open：是否跟踪打开，只有当邮件内容为"text/html"时有效。值为 1 时跟踪，其他值不跟踪；
   track_click：是否跟踪点击。值为 1 时跟踪，其他值不跟踪。也可以配置某个链接不跟踪，参见 打开和点击跟踪；
   track_subscription：是否添加退订链接，为 1 时添加，其他值不添加；
   custom_domain：自定义跟踪域名。要求此域名已在平台验证通过，否则将采用系统缺省域名；
   priority：邮件优先级，可设定为 high、median 和 low 三种，不填的话默认为 low；
   

示例如下：

 X-Easeye-API: {
   "category": "Registration",
   "campaign": "registration email for new users",
   "send_options": {
       "track_open": 1,
       "track_click":1,
       "track_subscription":1,
       "custom_domain":"http://linktrace.test.com"
       },
   "priority":"low"
  }

X-Easeye-UniqueMsgID
作为发送方维度的邮件唯一标识，用于消息去重、投递链路追踪与状态回调匹配，最大长度50 byte，字符范围是大小写字母，阿拉伯数字和减号；
示例如下：

 X-Easeye-UniqueMsgID: sendseqid-89897254234

X-Easeye-ExpirationDate
设置邮件投递过期时间，超时未投递成功则终止投递，返回过期状态。
时间格式为：yyyy-MM-dd HH:mm:ss，时区为东八区；
示例如下：

 X-Easeye-ExpirationDate: 2024-10-09 11:03:25

SMTP响应码

您的每次 SMTP 调用都会返回一个响应码。2XX成功响应码，邮件接收成功，4XX临时错误，可以重试，5XX永久错误，不要继续尝试投递。