Webservice方法-ImportListSentTag接口
介紹
調用本接口可以給聯繫人添加指定列表使用的發送標籤與對應的值,這些標籤和值只有在發送指定列表時才會被使用。
方法聲明如下:
Public EaseyeReturnDTO ImportListSentTag (EaseyeUserAccountDTO easeyeUserAccountDTO,string mailListName, string[] tagName,ListSentTagDTO[] listSentTagArray)
輸入
- EaseyeUserAccountDTO:easeyeUserAccountDTO
- 用戶帳戶信息(必填),其字段詳細信息如下:
Index | Field | Type | Desc | 最佳實踐 |
---|---|---|---|---|
1 | 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):某個必須的字段缺失;