Webservice方法-GetMailContactInAction接口
介绍
调用本接口可以查询一段时间内发生指定操作的联系人的详细情况,由于返回数据量可能较大,目前通过分页返回结果,每页显示数目和当前页数由您传入;
方法声明如下:
public MailContactInActionReturnDTO GetMailContactInAction(EaseyeUserAccountDTO easeyeUserAccountDTO, int sentFlag, DateTime dateFrom, DateTime dateTo, int pageSize, int currentPageIndex)
输入
- EaseyeUserAccountDTO:easeyeUserAccountDTO
- 用户帐户信息(必填),其字段详细信息如下:
Index | Field | Type | Desc |
---|---|---|---|
1 | 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 | 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人)