接口与推送
亿业云提供SMTP接口服务，根据邮件业务类型分为26（营销）和27（事务）端口。需按照不同的业务场景选择对应的端口，并配置独立的发送方。同一个发送域名不能用于不同的端口使用，可能导致发送效果互相影响。
如业务场景较多，则建议不同类型或优先级的邮件发送域名都进行隔离。如同样是事务邮件，验证码、密码找回等高优先级事务邮件应与普通的通知类事务邮件进行隔离，避免影响发送速度。 也便于根据不同的发送方来分析和对比不同业务场景的效果，避免交叉影响。
接口配置
在“接口配置”页面，点击下载“邮件API”或“短信HHTP”接口文档，参考文档进行接口配置。 如企业的系统防火墙设置了针对外部访问IP的屏蔽/开放策略，可在此页面获取IP添加至白名单，以保证可正常连接调用。
接口对接流程：
- 获取密钥：点击“创建密钥”，系统将随机生成访问ID（账号）和密码。一个账号最多同时支持3个密钥。如果您丢失或遗忘了访问密钥，无法找回，可以创建一个新的访问密钥配置后，再将旧密钥删除。
- 发件人设置：可参考“邮件配置”（可点击跳转）页面对发件人域名进行解析，解析完成后添加至平台即可应用于接口发送。
- 信息报备：为保证接口邮件发送效果，建议测试接口调用前通知对应客服，以便根据实际业务场景配置对应的资源通道。如未报备则调用默认通道，默认通道可能导致测试速度或效果受到共用通道的其他客户影响。
接口设置常见错误原因及解决：
| 错误信息 | 说明 |
|---|---|
| 530 Authentication failed. | 认证失败，可能使用了错误的用户名或接口密码。 |
| 540 permission required | 权限未开通，请联系客服人员开通。 |
| 553 mail from <xxxx@easeye.com.cn1> not allowedcode message [txsID=JT9LSLJZ-1]; in reply to MAIL | 发送方未在edm平台登记，还不能使用。参考接口配置前的准备工作2-发送方邮箱设置。 |
| 553 mail <.xxxx@easeye.123> not allowed (E.g., mailbox syntaxincorrect)codemessage [txsID=JT9LTF0I-1]; in reply to RCPT | 接收方地址格式不正确，一个合法的邮件地址需要满足以下要求： @前半部分，可以含有数字、大小写字母、.!#$%&'*+/=?^_`{|}~- 等符号; @前半部分，只能字母或数字开头； @前半部分，点不能连续多个，且不能在最后一位； @后半部分，可以含有数字、大小写字母、.-； @后半部分，只能字母或数字开头与结尾； @后半部分，点与减号不能连续 |
| 502 Email content is too large([length]) | 邮件内容太大，超过接口接收的上限（建议不超过5M）。 |
| 451 billing business error (the account balance (accountId=287,userid=1237,availablePoints=10) is not enough) code message [txsID=JT9MNEZX-1]; in reply to DATA | 账户余额不足，请联系客服充值。 |
Webhook配置
一种轻量级的事件驱动通信机制，基于HTTP的回调函数，允许亿业云服务器在特定事件发生时主动向客户端发送数据。可在“Webhook配置”页面，勾选需要获取的邮件事件类型。包括：
- Dropped：过滤。通常是对历史发送过的硬退数据（即邮箱无效）或退订过的数据进行过滤。只应用于营销端口。
- Bounced：拒信。包括不同原因的拒信。回执中字段为Reason:100 表示硬退，即邮箱无效导致的拒信；字段为Reason:101表示软退，即对方服务器或对方收件人拒信。
- Delivered：已送达至对方邮箱。
- SpamReport：邮箱运营商反馈的投诉。
- Opened：打开/阅读邮件。
- Clicked：点击邮件中的链接。
- Unsubscribed：退订或举报。
可点击 “查看文档” 获取完整的接口相关信息。