Webservice方法-GetMailReportDetail接口

出自亿业科技接口
在2017年2月16日 (四) 10:02由Lebesgue.yu對話 | 貢獻所做的修訂版本

(差異) ←上個修訂 | 最新修訂 (差異) | 下一修訂→ (差異)
跳轉到: 導覽搜尋

介紹

調用本接口可以查詢某次發送的某類數據的詳細情況,由於返回數據量可能較大,結果目前通過分頁返回,每頁顯示數目和當前頁數由您傳入;
方法聲明如下:

public MailReportDetailReturnDTO GetMailReportDetail(EaseyeUserAccountDTO easeyeUserAccountDTO,
int sentMailListId, int sentFlag,int pageSize,int currentPageIndex)

輸入

  • EaseyeUserAccountDTO:easeyeUserAccountDTO
用戶帳戶信息(必填),其字段詳細信息如下:
Index Field Type Desc 最佳實踐
1 Email 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 Email 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):某個必須的字段缺失;