获取未确认订阅收件人
Get unconfirmed subscribers 获取未确认订阅收件人
UnconfirmedSubscribers允许获取未确认订阅的收件人列表. 可通过列表ID或者日期范围进行筛选过滤.
请求数据格式
| 参数 | 类型 | 描述 |
|---|---|---|
| apiKey | string | 你的API Key, 需要验证. 必填. |
| listIds | int (CSV) | 列表标识. 选填. 如指定, 只返回选定列表中未确认订阅的收件人. 如未指定, 返回所有未确认订阅的收件人. 如需指定多个列表, 使用逗号分隔符, 比如: 12,34,56,789 |
| startDate | date | 起始日期. 选填. 所有参数 (startDate，endDate) 都用来指定统计范围. 否则会被忽略. YYYY-MM-DD 格式. |
| endDate | date | 见开始日期 |
注意: 只有API秘钥是必须提供的参数, 如忽略其他参数, 会获取所有未确认订阅的收件人
应答
| 元素/属性 | 类型 | 描述 |
|---|---|---|
| UnconfirmedSubscribersList | array[complex] | UnconfirmedSubscriber数组元素 |
UnconfirmedSubscriber子元素:
| 元素/属性 | 类型 | 描述 |
|---|---|---|
| string | 未确认注册收件人Email地址 | |
| ListId | int | 未确认注册收件人列表ID |
| SubscribedOn | dateTime | 确认订阅日期和时间 |
示例
| GET https://api.esv2.com/v2/Api/UnconfirmedSubscribers?apiKey=test_api_key1 HTTP/1.1 Accept-Encoding: gzip,deflate Host: api.esv2.com User-Agent: Apache-HttpClient/4.1.1 (java 1.5) |
| HTTP/1.1 200 OK Cache-Control: private Content-Type: text/xml; charset=utf-8 Server: Microsoft-IIS/7.5 X-AspNetMvc-Version: 5.1 X-AspNet-Version: 4.0.30319 X-Powered-By: ASP.NET Date: Wed, 05 Mar 2014 12:16:49 GMT Content-Length: 591 <ApiResponse xmlns:xsd=”http://www.w3.org/2001/XMLSchema” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”> |