Webservice方法-GetMailSumReport介面

出自亿业科技接口
跳轉到: 導覽搜尋

介紹

調用本介面可以查詢若干個列表的發送情況;
方法聲明如下:

public MailSumReportReturnDTO GetMailSumReport(EaseyeUserAccountDTO easeyeUserAccountDTO,
string projectName, string maillistName,DateTime sentDatetimeFrom, DateTime sentDatetimeTo)

輸入

  • EaseyeUserAccountDTO:easeyeUserAccountDTO
用戶帳戶信息(必填),其欄位詳細信息如下:
Index Field Type Desc 最佳實踐
1 Email string(50) 用戶名(必填) 登錄名
2 Password string(50) 密碼(必填) 介面密碼(不是人工登錄密碼
注:1)Email是用户名,也就是平台的登录帐号;
  • string:projectName
待查詢列表所在項目(可選);
最佳實踐:不填,或者設置為空""
  • string:maillistName
待查詢的列表名稱(可選);
最佳實踐:不填,或者設置為空""
  • DateTime:sentDatetimeFrom
查詢的開始時間(可選);
最佳實踐:填寫為10天前的凌晨0點0分0秒
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为”yyyy-MM-ddThh:mm:ss”,其中,各个数值所占位数必须符合格式定义,
不足则补0,比如”2012-07-03T03:23:01”;
  • DateTime:sentDatetimeTo
查詢的結束時間(可選);
最佳實踐:填寫為今天的23點59分59秒
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为”yyyy-MM-ddThh:mm:ss”,其中,各个数值所占位数必须符合格式定义,
不足则补0,比如”2012-07-03T03:23:01”;

處理

根據條件查詢報表,並將結果返回;

輸出

  • MailSumReportReturnDTO
報表總計查詢的返回信息,包含以下屬性
Index Field Type Desc
1 ErrorCode Int 錯誤碼,3位整數,
2xx:處理成功;
3xx:部分成功;
4xx:臨時錯誤;
5xx:永久錯誤
2 ErrorInfo string 發生臨時錯誤和永久
錯誤時,攜帶失敗的原因
3 MailSumReportDTOList List
<MailStatusReportDTO>
查詢總報表的返回信息
  • List<MailStatusReportDTO>
查詢總報表的返回信息,其MailStatusReportDTO結構的欄位詳細信息如下:
Index Field Type Desc
1 Sent int 發送數量
2 Bounce int 硬退信數量
3 BounceFalse int 軟退信數量
4 OptOut int 退訂數量
5 Open int 打開數量
6 Success int 成功數量
7 MailClicked int 郵件點擊數
8 Transmit int 轉發數
9 SendTime DateTime 發送時間
10 FinishTime DateTime 結束時間
11 SentMailListId int 本次發送的ID,用來查詢詳細報表報表
12 MailListName string 本次發送的郵件列表名稱
13 MailProjectName string 本列表所屬項目名稱
注:1)硬退是指地址不存在;
2)软退是指非地址不存在造成的失败;
3)邮件点击数是指邮件点击人数,单人点击多次仍然只计入一次;
常見調用失敗情況
(4xx):業務限制;
(4xx):資料庫操作失敗;
(5xx):某個欄位長度不符合定義;
(5xx):某個必須的欄位缺失;