Webservice方法-GetMailReportDetail接口
出自亿业科技接口
介紹
調用本接口可以查詢某次發送的某類數據的詳細情況,由於返回數據量可能較大,結果目前通過分頁返回,每頁顯示數目和當前頁數由您傳入;
方法聲明如下:
public MailReportDetailReturnDTO GetMailReportDetail(EaseyeUserAccountDTO easeyeUserAccountDTO, int sentMailListId, int sentFlag,int pageSize,int currentPageIndex)
輸入
- EaseyeUserAccountDTO:easeyeUserAccountDTO
- 用戶帳戶信息(必填),其字段詳細信息如下:
Index | Field | Type | Desc | 最佳實踐 |
---|---|---|---|---|
1 | string(50) | 用戶名(必填) | 登錄名 | |
2 | Password | string(50) | 密碼(必填) | 接口密碼(不是人工登錄密碼) |
注:1)Email是用户名,也就是平台的登录帐号;
- int:sentMailListId
- 待查詢列表的唯一編號(必填);
注:1)该编号是从获取列表明细接口中获取到的:
- int:sentFlag
- 待查詢的類型(必填):其允許值如下:
- 0:硬退類型,3:退訂類型,4:打開類型,5:點擊類型;9:軟退類型,
- int:pageSize
- 每頁顯示的記錄條數(必填,正整數,不大於1000);
- int:currentPageIndex
- 當前的頁數(必填,正整數);
處理
根據條件查詢分頁報表,並將結果返回;
輸出
- MailReportDetailReturnDTO
- 報表總計查詢的返回信息,包含以下屬性
Index | Field | Type | Desc |
---|---|---|---|
1 | ErrorCode | Int | 錯誤碼,3位整數, 2xx:處理成功; 3xx:部分成功; 4xx:臨時錯誤; 5xx:永久錯誤 |
2 | ErrorInfo | string | 發生臨時錯誤和永久 錯誤時,攜帶失敗的原因 |
3 | MailReportDetailDTOList | List < ReportDetail> |
查詢報表明細的返回信息 |
- List<ReportDetail>
- 查詢總報表的返回信息,其ReportDetail結構的字段詳細信息如下:
Index | Field | Type | Desc |
---|---|---|---|
1 | String | 接收方郵件地址 | |
2 | SentFlag | int | 狀態類型 |
3 | ModifiedDate | DateTime | 操作時間(在點擊報表中,指 最後一次的鏈接點擊時間 ) |
4 | Link | String | 點擊的鏈接地址(適用於點擊 類型或者轉發的郵件地址) |
5 | Times | int | 點擊次數(只適用於點擊類型) |
6 | IPAddress | String | 該操作的源IP |
注:1)SentFlag的值和传入参数的sentFlag值相同;
2)ModifiedDate在点击类型查询中,是指该用户最后一次点击该链接的时间;在其他类型的查询中,是指该操作的发生时间;
- 常見調用失敗情況
- (4xx):業務限制;
- (4xx):數據庫操作失敗;
- (5xx):某個字段長度不符合定義;
- (5xx):某個必須的字段缺失;