获得无效的(被拒收的)记录条目
Get rejected subscribers 获得无效的(被拒收的)记录条目
ImportToListRejected接口允许取回一个在导入过程中由于各种原因被系统拒收的收件人列表. 执行一个GET请求将可返回一个CSV文件. 这个信息也能在后台手动通过报告->导入页面得到.
请求数据格式
请求 URL 参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| apiKey | string | 您的API Key，为了认证身份. 必填. |
| id | integer | 导入列表的任务ID。ID将在发起导入时出现 |
示例:
| https://api.esv2.com/v2/Api/ImportToListRejected?apiKey=YOUR_API_KEY_HERE&id=123 |
应答
这种接口与其他接口不同的是返回的数据是以CSV格式, 而不是XML. 这是因为这些数据的数量通常会更大一些. CSV会减少管理成本, 而且一般来说会更容易解析及操作.
应答内容类型应为“text/csv”. 返回的数据包括具有各列名称的表头. 输出的CSV格式将遵循以下设置：
Field separator字段分隔符: comma逗号 (,)
Quoting character引用符: (“)
Escape character换码符: (“)
Encoding编码: UTF-8
CSV应答列名:
| 名称 | 类型 | 描述 |
|---|---|---|
| Value | string | 被拒收的收件人Email或者电话号码 |
| Problem | string | 收件人Email被拒收的原因. 所有可能的原因请见后. |
拒收原因 (他们中的任一会出现在 CSV文件 的Problem列中):
| 名称 | 描述 |
|---|---|
| Conflicting Custom Subscriber ID | 收件人标识ID与现有收件人冲突. |
| Conflicting Email | email地址与现有收件人冲突. |
| Conflicting Phone | 电话号码与现有收件人冲突. |
| Country/Region blacklisted | 拨号前缀出现在本地黑名单中. |
| Domain blacklisted | 域名出现在本地黑名单中. |
| Domain rejected | 域名出现在全球黑名单中. |
| Duplicated Custom Subscriber ID | 重复导入收件人标识ID. |
| Duplicated Email | 重复导入email地址. |
| Duplicated Phone | 重复导入收件人电话号码. |
| Email blacklisted | email地址出现在本地黑名单中. |
| Email rejected | 收件人不存在或被举报. |
| Empty Custom Subscriber ID | 收件人标识ID为空 |
| Empty email | email地址为空 |
| Empty phone number | 电话号码为空 |
| Entries skipped because of selected import type | 导入值不符合导入要求 |
| Invalid | 导入的数据是非Email格式 (格式错误 等等) |
| Invalid Custom Subscriber ID | 字符串不是一个有效的收件人标识ID |
| Invalid email address | 字符串不是一个有效的email地址 |
| Invalid phone number | 字符串不是一个有效的电话号码 |
| Opted out | 收件人从列表中退订 (当导入选项AllowImportingUnsubscribed为false). |
| Parsing error | 导入文件条目出现损坏无法解析. |
| Phone blacklisted | 电话号码出现在本地黑名单中. |
| Phone rejected | 电话号码出现在全球黑名单中. |
| Skipped due to no value of a required custom field | 自定义属性字段必填项缺失. |
| Skipped Email | 因为未找到Email地址条目(在ReplaceOnly和UpdateOnly模式下)或列表中Email地址条目已存在(在AddOnly模式下)而忽略 |
| Skipped Phone | 因为未找到电话号码条目(在ReplaceOnly和UpdateOnly模式下)或列表中电话号码条目已存在(在AddOnly模式下)而忽略 |
示例
请求:
|
GET http://api.esv2.com/v2/Api/ImportToListRejected?apiKey=test_api_key1&id=287 HTTP/1.1
Accept-Encoding: gzip,deflate
Host: api.esv2.com
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
|
OK应答:
| HTTP/1.1 200 OK Cache-Control: private Content-Type: text/csv; charset=utf-8 Server: Microsoft-IIS/7.5 X-AspNetMvc-Version: 5.1 X-AspNet-Version: 4.0.30319 Set-Cookie: TEMP_DATA=27aa335a-4ef6-49c0-af32-d143691fa14b; path=/ X-Powered-By: ASP.NET Date: Tue, 24 Jun 2014 10:47:38 GMT Content-Length: 31336 Value,Problem |