Webservice方法-CancelMaillist接口

從 亿业科技接口
跳到: 導覽搜尋

介紹

調用本接口可以取消某個正在審核中的列表,或者某個定時發送的,尚未發送的列表;
方法聲明如下:

public EaseyeDetailedResultReturnDTO CancelMaillist(EaseyeUserAccountDTO easeyeUserAccountDTO, string mailListName)

輸入

  • EaseyeUserAccountDTO:easeyeUserAccountDTO
用戶帳戶信息(必填),其字段詳細信息如下:
Index Field Type Desc
1 Email 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):列表不存在,或列表狀態非審核狀態或者定時發送狀態;