Webservice方法-GetMailSumReport介面
介紹
調用本介面可以查詢若干個列表的發送情況;
方法聲明如下:
public MailSumReportReturnDTO GetMailSumReport(EaseyeUserAccountDTO easeyeUserAccountDTO, string projectName, string maillistName,DateTime sentDatetimeFrom, DateTime sentDatetimeTo)
輸入
- EaseyeUserAccountDTO:easeyeUserAccountDTO
- 用戶帳戶信息(必填),其欄位詳細信息如下:
Index | Field | Type | Desc | 最佳實踐 |
---|---|---|---|---|
1 | 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):某個必須的欄位缺失;