/v2/Api/ImportToListRejected GET
Метод ImportToListRejected позволяет получить список подписчиков, отклоненных системой по разным причинам при импорте в листы. GET-запрос возвращает данные в формате CSV. Это та же самая информация, которую можно получить вручную через веб интерфейс ExpertSender через страницу Отчеты -> По импорту листов.
| Элемент | Тип | Описание |
|---|---|---|
| apiKey | string | Ваш API-ключ, необходимый для авторизации. Обязательный. |
| Id | integer | Идентификатор задачи импорта в лист. Получить ID задачи можно при планировании импорта подписчиков в лист |
Пример:
https://api.esv2.com/v2/Api/ImportToListRejected?apiKey=Ваш_API_ключ&id=123
Ответы
Этот метод отличается от других тем, что возвращает ответ в CSV-формате, а не в XML. Сделано это потому, что иногда объем данных бывает очень большим. CSV позволяет проще парсить и обрабатывать данные.
Content-type ответа — «text/csv». Данные содержат строку заголовков. CSV формируется, если использовать следующие настройки:
- разделитель полей: запятая (,)
- ограничитель: двойная кавычка (")
- кодировка: UTF-8
Колонки csv ответа:
| Название | Тип | Описание |
|---|---|---|
| Line | string | Отклоненный емейл |
| Problem | string | Причина, по которой емейл был отклонен. Список возможных проблем смотрите ниже. |
Причины отклонения (одна из которых может быть в столбце Problem в CSV):
| Название | Описание |
|---|---|
| Invalid | Запись является невалидным емейл адресом (неправильное форматирование, опечатка и т.д.) |
| Blacklisted | Емейл отклонен, так как находится в черном списке |
| Unsubscribed | Подписчик отписался от листа (работает только для импорта с опцией AllowImportingUnsubscribed, установленной в false) |
| BlacklistedDomain | Емейл отклонен, так как его домен находится в черном списке |
| Skipped | Емейл пропущен, так как не соответствует типу импорта (только при типе импорта "IgnoreAndUpdate" или "IgnoreAndReplace") |
| Rejected | Емейл отклонен по внутреннему правилу. Обычно это значит, что адрес не существует, либо имели место жалобы |
| RejectedDomain | Домен емейла отклонен по внутреннему правилу |
Примеры
Запрос:
GET http://api.esv2.com/v2/Api/ImportToListRejected?apiKey=Ваш_API_ключ&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)
ОК Ответ:
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 Line,Problem invalid1.@domain.com,Invalid invalid2@.domain.com,Invalid blacklisted@domain.com,Blacklisted username@blacklisted.com,BlacklistedDomain ...