Webservice方法-GetMailContactInAction接口
介紹
調用本接口可以查詢一段時間內發生指定操作的聯繫人的詳細情況,由於返回數據量可能較大,目前通過分頁返回結果,每頁顯示數目和當前頁數由您傳入;
方法聲明如下:
public MailContactInActionReturnDTO GetMailContactInAction(EaseyeUserAccountDTO easeyeUserAccountDTO, int sentFlag, DateTime dateFrom, DateTime dateTo, int pageSize, int currentPageIndex)
輸入
- EaseyeUserAccountDTO:easeyeUserAccountDTO
- 用戶帳戶信息(必填),其字段詳細信息如下:
Index | Field | Type | Desc |
---|---|---|---|
1 | 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 | 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人)