Webservice方法-GetMailContactInAction接口

来自亿业科技接口
跳转至: 导航搜索

介绍

调用本接口可以查询一段时间内发生指定操作的联系人的详细情况,由于返回数据量可能较大,目前通过分页返回结果,每页显示数目和当前页数由您传入;
方法声明如下:

public MailContactInActionReturnDTO GetMailContactInAction(EaseyeUserAccountDTO
easeyeUserAccountDTO, int sentFlag, DateTime dateFrom, DateTime dateTo, int pageSize, int
currentPageIndex)

输入

  • EaseyeUserAccountDTO:easeyeUserAccountDTO
用户帐户信息(必填),其字段详细信息如下:
Index Field Type Desc
1 Email string(50) 用户名(必填)
2 Password string(50) 密码(必填)
注:1)Email是用户名,也就是平台的登录帐号:
  • int:sentFlag
待查询的操作类型(必填):其允许值如下:
0:硬退类型,3:退订类型,
  • DateTime:dateFrom
该操作发生的时间下限(必填);
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为“yyyy-MM-ddThh:mm:ss”,
其中,各个数值所占位数必须符合格式定义,不足则补0,比如“2012-07-03T03:23:01”
  • DateTime:dateTo
该操作发生的时间上限(必填);必须大于时间下限dateFrom。
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为“yyyy-MM-ddThh:mm:ss”,
其中,各个数值所占位数必须符合格式定义,不足则补0,比如“2012-07-03T03:23:01”
  • int:pageSize
每页显示的记录条数(必填,正整数,不大于1000);
  • int:currentPageIndex
当前的页数(必填,正整数);

处理

根据条件查询分页报表,并将结果返回;

输出

  • MailContactInActionReturnDTO
查询点发明细报表的返回信息,包含以下属性:
Index Field Type Desc
1 ErrorCode int 错误码,3位整数
2xx:处理成功;
3xx:部分成功;
4xx:临时错误;
5xx:永久错误
2 ErrorInfo string 发生临时错误和永久
错误时,携带失败的原因
3 Contacts List
<MailContactInActionDTO>
操作详细信息
注:1)判断是否成功的标准取决于ErrorCode,其取值范围和取值含义见它的描述;
2)一般来说,临时失败(4xx)建议等待一个随机时间后重试,可设定最大重试次数;
重试若干次如果仍然失败,通知管理员联系我方,同时将ErrorInfo的值记录下来,一并告知我方;
3)永久失败(5xx)不建议重试,发生5xx时,通知管理员联系我方,同时将ErrorInfo的值记录下来,一并告知我方;
其中MailContactInActionDTO结构的字段详细信息如下:
Index Field Type Desc
1 Email string 接收方邮件地址
2 SentFlag int 状态类型
3 ActDateTime DateTime 操作发生时间
4 IP string 操作发生的IP地址(只适用于退订类型)
5 ActDescription string 操作相关描述信息(退订类型时表示退订原因)
6 SentMailListName string 所属列表名称
7 SentMailListDateTime DateTime 所属列表发送时间
注:1)SentFlag的值和传入参数的sentFlag值相同;
2)ActDateTime是指该操作的发生时间;
常见调用失败情况
(4xx):业务限制;
(4xx):数据库操作失败;
(5xx):某个字段长度不符合定义;
(5xx):某个必须的字段缺失;
(6xx):联系人Email地址格式校验不通过;
(6xx):一次导入的联系人过多(大于1000人)