接口设置和注意事项

 2020/7/14  89     关键词:开发者 接口设置
分享到:

接口设置和注意事项

Webservice接口设置和注意事项

Webservice接口设置

1)WebService服务地址:http://app.easeye.com.cn/MailWebService/MailWebService.asmx

2)WSDL文件地址:http://app.easeye.com.cn/MailWebService/MailWebService.asmx?WSDL

注:关于加密传输说明:支持HTTPS协议,但相应证书是自签名,请注意忽略相关告警即可;

Webservice接口注意事项

1)请务必在日志中记录每次调用接口返回值和错误描述,方便出现问题时定位;

2)请注意控制HTTP请求的长度不要过大(10M以内);比如导入联系人接口,如果联系人数目过多(比如几百万联系人),可能会造成长度过大的情况;这种情况下可以分批调用导入联系人接口导入,每批控制在1万左右即可;

SMTP接口设置和注意事项

SMTP接口设置

1)SMTP服务器地址:smtp.easeye.com.cn.(主服务器)和backup-smtp.easeye.com.cn.(备用服务器)

2)SMTP服务端口:26端口(营销端口)和27端口(事务端口),具体区别请参考开发前准备工作中的SMTP权限说明;

3)其他信息:用户名,密码,发送方,具体说明请参考开发前准备工作中的SMTP开发前准备工作;

注:关于加密传输说明:不支持starttls命令;支持SSL协议,但相应证书是自签名,请注意忽略相关告警即可;加密传输对应的端口分别是2026端口(营销端口)和2027端口(事务端口);

SMTP接口注意事项

1)由于事务邮件比较重要,我们提供主备服务器以解决机房网络故障引发的提交失败;建议提交时,默认链接主服务器(smtp.easeye.com.cn.),如果遇到网络问题导致提交失败,链接备用服务器(backup-smtp.easeye.com.cn.);

注:关于可靠性说明:主服务器机房属于五星级机房,发生网络故障的概率极小,但确实不能保证100%不发生网络故障;网络故障发生后我们会尽快对主服务器域名的A记录进行修改,但介于DNS记录的缓存机制,需要一定的时间来生效;所以,我们建议提交邮件失败时,如果确认是网络异常,可以尝试使用备用服务器进行提交,以确保事务邮件的可靠性;

2)不论提交成功还是提交失败,请在日志中记录SMTP的返回码和返回描述;方便在邮件提交失败时,或者邮件提交成功但未收到时,和我方沟通使用;

3)SMTP并发数请控制在50个并发链接以内;

4)SMTP邮件大小一般建议在100K左右,如果超过1M大小,请联系我方进行确认;过大会导致成功率降低,建议附件通过链接的方式请用户下载;

5)营销邮件请走营销端口(26端口);营销邮件如果走事务端口,我们会有相应的惩罚,情节严重者会直接关停账号;

6)邮件正文建议使用quoted-printable 或者 base64 编码,提高兼容性;

Webhook接口设置和注意事项

Webhook接口设置

1)登录平台,设置webhook的URL即可,具体请参考开发前准备工作中的Webhook配置;

注:关于加密传输说明:支持HTTPS协议,直接配置url即可;

Webhook接口注意事项

1)客户接口接收数据后需尽快返回HTTP状态200,否则会重复同步; 我方目前等待HTTP响应的超时时间为60秒,但后续可能视情况调整为更短; 所以,建议您接受到完整的数据包并成功的保存在本地后,立刻回复HTTP状态200,然后再通过其他服务来处理后续业务;

2)考虑到网络因素,可能会出现重复同步的情况,请添加相应业务逻辑,避免报表数据不准; Webhook采用HTTP协议POST方式,URL后面会附带参数id,此参数是状态事件包的流水号,客户可从此字段判断出事件包是否已接收;

3)投递过程中出现异常后,我们会在24小时内持续重试,超过24小时会丢弃该包; 投递过程中的异常包括:未投递成功,或者未收到HTTP响应消息,或者HTTP响应消息状态不是200;


更多关于邮件营销,敬请关注亿业科技

联系我们:400-018-0383

官网:www.easeye.com.cn

Anti-spam StatementPrivacy & Security StatementSite Map
Copyright © 2007-2019 Shanghai YIYE Network Technology Development Co., Ltd. All right reserved H.ICP.B. NO. 07501641  HGWAB No. 31011502003380