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):某个必须的字段缺失;