接口設置和注意事項

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；