“接口设置和注意事项”版本间的差异
Lebesgue.yu(讨论 | 贡献) (以“==Webservice接口设置和注意事项== ===Webservice接口设置=== :1)WebService服务地址:http://app.easeye.com.cn/MailWebService/MailWebService.asmx :2...”为内容创建页面) |
Lebesgue.yu(讨论 | 贡献) |
||
第14行: | 第14行: | ||
==SMTP接口设置和注意事项== | ==SMTP接口设置和注意事项== | ||
===SMTP接口设置=== | ===SMTP接口设置=== | ||
− | :1)SMTP服务器地址:smtp.easeye.com.cn.(主服务器)和backup | + | :1)SMTP服务器地址:smtp.easeye.com.cn.(主服务器)和backup-smtp.easeye.com.cn.(备用服务器) |
:2)SMTP服务端口:26端口(营销端口)和27端口(事务端口),具体区别请参考[[开发前准备工作]]中的[[开发前准备工作#SMTP权限说明|SMTP权限说明]]; | :2)SMTP服务端口:26端口(营销端口)和27端口(事务端口),具体区别请参考[[开发前准备工作]]中的[[开发前准备工作#SMTP权限说明|SMTP权限说明]]; | ||
:3)其他信息:用户名,密码,发送方,具体说明请参考[[开发前准备工作]]中的[[开发前准备工作#SMTP开发前准备工作|SMTP开发前准备工作]]; | :3)其他信息:用户名,密码,发送方,具体说明请参考[[开发前准备工作]]中的[[开发前准备工作#SMTP开发前准备工作|SMTP开发前准备工作]]; | ||
第23行: | 第23行: | ||
===SMTP接口注意事项=== | ===SMTP接口注意事项=== | ||
:1)由于事务邮件比较重要,我们提供主备服务器以解决机房网络故障引发的提交失败; | :1)由于事务邮件比较重要,我们提供主备服务器以解决机房网络故障引发的提交失败; | ||
− | ::建议提交时,默认链接主服务器(smtp.easeye.com.cn.),如果遇到网络问题导致提交失败,链接备用服务器(backup | + | ::建议提交时,默认链接主服务器(smtp.easeye.com.cn.),如果遇到网络问题导致提交失败,链接备用服务器(backup-smtp.easeye.com.cn.); |
注:关于可靠性说明: | 注:关于可靠性说明: | ||
主服务器机房属于五星级机房,发生网络故障的概率极小,但确实不能保证100%不发生网络故障; | 主服务器机房属于五星级机房,发生网络故障的概率极小,但确实不能保证100%不发生网络故障; |
2019年7月24日 (三) 03:44的最后版本
目录
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接口设置
注:关于加密传输说明: 支持HTTPS协议,直接配置url即可;
Webhook接口注意事项
- 1)客户接口接收数据后需尽快返回HTTP状态200,否则会重复同步;
- 我方目前等待HTTP响应的超时时间为60秒,但后续可能视情况调整为更短;
- 所以,建议您接受到完整的数据包并成功的保存在本地后,立刻回复HTTP状态200,然后再通过其他服务来处理后续业务;
- 2)考虑到网络因素,可能会出现重复同步的情况,请添加相应业务逻辑,避免报表数据不准;
- Webhook采用HTTP协议POST方式,URL后面会附带参数id,此参数是状态事件包的流水号,客户可从此字段判断出事件包是否已接收;
- 3)投递过程中出现异常后,我们会在24小时内持续重试,超过24小时会丢弃该包;
- 投递过程中的异常包括:未投递成功,或者未收到HTTP响应消息,或者HTTP响应消息状态不是200;