Webservice方法-GetMailContactInAction接口

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

介紹

調用本接口可以查詢一段時間內發生指定操作的聯繫人的詳細情況,由於返回數據量可能較大,目前通過分頁返回結果,每頁顯示數目和當前頁數由您傳入;
方法聲明如下:

public MailContactInActionReturnDTO GetMailContactInAction(EaseyeUserAccountDTO
easeyeUserAccountDTO, int sentFlag, DateTime dateFrom, DateTime dateTo, int pageSize, int
currentPageIndex)

輸入

  • EaseyeUserAccountDTO:easeyeUserAccountDTO
用戶帳戶信息(必填),其字段詳細信息如下:
Index Field Type Desc
1 Email string(50) 用戶名(必填)
2 Password string(50) 密碼(必填)
注:1)Email是用户名,也就是平台的登录帐号:
  • int:sentFlag
待查詢的操作類型(必填):其允許值如下:
0:硬退類型,3:退訂類型,
  • DateTime:dateFrom
該操作發生的時間下限(必填);
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为“yyyy-MM-ddThh:mm:ss”,
其中,各个数值所占位数必须符合格式定义,不足则补0,比如“2012-07-03T03:23:01”
  • DateTime:dateTo
該操作發生的時間上限(必填);必須大於時間下限dateFrom。
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为“yyyy-MM-ddThh:mm:ss”,
其中,各个数值所占位数必须符合格式定义,不足则补0,比如“2012-07-03T03:23:01”
  • int:pageSize
每頁顯示的記錄條數(必填,正整數,不大於1000);
  • int:currentPageIndex
當前的頁數(必填,正整數);

處理

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

輸出

  • MailContactInActionReturnDTO
查詢點發明細報表的返回信息,包含以下屬性:
Index Field Type Desc
1 ErrorCode int 錯誤碼,3位整數
2xx:處理成功;
3xx:部分成功;
4xx:臨時錯誤;
5xx:永久錯誤
2 ErrorInfo string 發生臨時錯誤和永久
錯誤時,攜帶失敗的原因
3 Contacts List
<MailContactInActionDTO>
操作詳細信息
注:1)判断是否成功的标准取决于ErrorCode,其取值范围和取值含义见它的描述;
2)一般来说,临时失败(4xx)建议等待一个随机时间后重试,可设定最大重试次数;
重试若干次如果仍然失败,通知管理员联系我方,同时将ErrorInfo的值记录下来,一并告知我方;
3)永久失败(5xx)不建议重试,发生5xx时,通知管理员联系我方,同时将ErrorInfo的值记录下来,一并告知我方;
其中MailContactInActionDTO結構的字段詳細信息如下:
Index Field Type Desc
1 Email string 接收方郵件地址
2 SentFlag int 狀態類型
3 ActDateTime DateTime 操作發生時間
4 IP string 操作發生的IP地址(只適用於退訂類型)
5 ActDescription string 操作相關描述信息(退訂類型時表示退訂原因)
6 SentMailListName string 所屬列表名稱
7 SentMailListDateTime DateTime 所屬列表發送時間
注:1)SentFlag的值和传入参数的sentFlag值相同;
2)ActDateTime是指该操作的发生时间;
常見調用失敗情況
(4xx):業務限制;
(4xx):數據庫操作失敗;
(5xx):某個字段長度不符合定義;
(5xx):某個必須的字段缺失;
(6xx):聯繫人Email地址格式校驗不通過;
(6xx):一次導入的聯繫人過多(大於1000人)