Webservice方法-ImportListSentTag接口

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

介紹

調用本接口可以給聯繫人添加指定列表使用的發送標籤與對應的值,這些標籤和值只有在發送指定列表時才會被使用。
方法聲明如下:

Public EaseyeReturnDTO ImportListSentTag (EaseyeUserAccountDTO easeyeUserAccountDTO,string mailListName,
string[] tagName,ListSentTagDTO[] listSentTagArray)

輸入

  • EaseyeUserAccountDTO:easeyeUserAccountDTO
用戶帳戶信息(必填),其字段詳細信息如下:
Index Field Type Desc 最佳實踐
1 Email string(50) 用戶名(必填) 登錄名
2 Password string(50) 密碼(必填) 接口密碼(不是人工登錄密碼
注:1)Email是用户名,也就是平台的登录帐号;
2)该登录账号应该是管理员账号。
  • string:mailListName
列表名稱(必填);
  • string[]: tagName
標籤名稱數組(必填),變量名稱和變量值的轉換和傳遞方法請參考使用webservice接口進行批量發送#如果主題或者內容中有變量,應該怎麼處理?
  • ListSentTagDTO[]: listSentTagArray
待添加的發送標籤信息(必填),其字段詳細信息如下:
Index Field Type Desc
1 To string(50) 聯繫人Email(必填)
2 TagValue string[] 標籤值數組(必填)應該和
tagName字段一一有序對應

處理

  • 將用戶提供的標籤數據保存下來,等待列表發送時使用;
  • 如果導入的發送標籤已存在(mailListName和聯繫人Email均相同),則更新標籤值;

輸出

  • EaseyeReturnDTO
添加聯繫組返回信息,其字段詳細信息如下:
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):某個必須的字段缺失;