Webservice方法-CancelMaillist介面
介紹
調用本介面可以取消某個正在審核中的列表,或者某個定時發送的,尚未發送的列表;
方法聲明如下:
public EaseyeDetailedResultReturnDTO CancelMaillist(EaseyeUserAccountDTO easeyeUserAccountDTO, string mailListName)
輸入
- EaseyeUserAccountDTO:easeyeUserAccountDTO
- 用戶帳戶信息(必填),其欄位詳細信息如下:
Index | Field | Type | Desc |
---|---|---|---|
1 | string(50) | 用戶名(必填) | |
2 | Password | string(50) | 密碼(必填) |
注:1)Email是用户名,也就是平台的登录帐号;
- string:mailListName
- 待取消發送的列表名稱(必填);
處理
根據列表名稱找到正在發送的列表,然後判斷其狀態是否允許取消,如果允許,取消該列表的發送,返回成功,否則,返回失敗;
當且僅當列表狀態處於如下的某一種狀態時,方可取消;
列表當前狀態為審核中;
- 列表為定時發送的列表,且當前時間未到該列表的保護時間內(保護時間是指,在
- 該列表即將發送時,不允許取消發送。目前保護時間定義為計劃發送時間的前2分鐘;也就是說,如果某個列表定時凌晨5:00發送,那麼凌晨4:58分後就不能取消了)
輸出
- EaseyeDetailedResultReturnDTO
- 導入聯繫人返回信息,其欄位詳細信息如下:
Index | Field | Type | Desc |
---|---|---|---|
1 | ErrorCode | Int | 錯誤碼,3位整數, 2xx:處理成功; 3xx:部分成功; 4xx:臨時錯誤; 5xx:永久錯誤 |
2 | ErrorInfo | string | 發生臨時錯誤和永久 錯誤時,攜帶失敗的原因 |
注:1)判断是否成功的标准取决于ErrorCode,其取值范围和取值含义见它的描述;
2)一般来说,临时失败(4xx)建议等待一个随机时间后重试,可设定最大重试次数;重试若干次如果仍然失败,通知管理员联系我方,同时将ErrorInfo的
值记录下来,一并告知我方;
3)永久失败(5xx)不建议重试,发生5xx时,通知管理员联系我方,同时将ErrorInfo的值记录下来,一并告知我方;
- 常見調用失敗情況
- (4xx):列表處於定時發送的保護時間範圍;
- (4xx):資料庫操作失敗;
- (5xx):某個欄位長度不符合定義;
- (5xx):某個必須的欄位缺失;
- (5xx):列表不存在,或列表狀態非審核狀態或者定時發送狀態;