接口设置和注意事项

来自亿业科技接口
跳转至: 导航搜索

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;