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