通过 SMTP 发送邮件

更新时间：2023-06-03 09:00

  1. 创建 API Key和 API 密钥。
  2. 设置接口的接入点(Host)为：smtp.effilink.co。
  3. 将API Key设置为用户名。
  4. 将API 密钥设置为密码。
  5. 依据业务需要选择不同端口(Port)。

提示

EffiLink 建议将接入点Host设置为 smtp.effilink.co，而不是直接指向 EffiLink 的IP地址。EffiLink 的IP地址偶尔会更改（维护或故障转移时），恕不另行通知，硬编码 IP 地址（尤其是没有定期检查更新的方法）可能会导致调用失败。

SMTP 端口

业务类型端口SSL加密端口
营销推广263026
系统事务273027

提示

  • 26与27端口是支持通过STARTTLS升级为加密链路的；
  • 避免使用以下弱算法：SSLv3 或 TLS 1.0/1.1，尽可能使用 TLS 1.2 或以上，最好是 TLS 1.3；
  • 避免使用以下弱加密套件：RC4, 3DES, AES-CBC, MD5, SHA1, NULL, EXPORT；

SMTP 扩展功能

现在，您已成功与 SMTP API 集成，如果有更多的功能需求，请了解如何使用SMTP 扩展功能。

速率限制

使用 EffiLink 的SMTP API发送电子邮件时，必须了解以下速率限制：

  • 您可以创建最多100个并发连接。
  • 单个邮件的大小限制为不超过10M。

SMTP响应码

您的每次 SMTP 调用都会返回一个响应码。200响应码通常是调用成功，400响应码通常是临时错误，可以重试，500响应码是永久错误，不要再继续尝试了。

响应码信息说明
250ok data code message [txsID=LYGSPGXH]; in reply to DATA此响应表示接口服务器已接受了邮件。
530Authentication failed.认证失败，可能使用了错误的API Key、API 密钥，或账户已过期。
540permission required权限未开通，请联系客服人员开通。
553mail from <xxxx@easeye.com.cn1> not allowed
code message [txsID=JT9LSLJZ-1]; in reply to MAIL		发送方未在平台登记，还不能使用。如何添加请参考发件人设置。
553mail <.xxxx@easeye.123> not allowed
(E.g., mailbox syntaxincorrect)
codemessage [txsID=JT9LTF0I-1]; in reply to RCPT		接收方地址格式不正确，一个合法的邮件地址需要满足以下要求：
@前半部分，可以含有数字、大小写字母、.!#$%&'*+/=?^_`{|}~- 等符号
@前半部分，只能字母或数字开头；
@前半部分，点不能连续多个，且不能在最后一位
@后半部分，可以含有数字、大小写字母、.-；
@后半部分，只能字母或数字开头与结尾；
@后半部分，点与减号不能连续
502Email content is too large([length])邮件内容太大，超过接口接收的上限，单个邮件的大小不能超过10M。
451billing business error (the account balance
(accountId=287,userid=1237,availablePoints=10) is not enough)
code message [txsID=JT9MNEZX-1]; in reply to DATA		账户余额不足，请联系客服充值。