/v2/Api/ImportToListTasks POST

Позволяет запланировать импорт в лист подписчиков. Подписчики импортируются из внешнего источника, например, из файла находящегося на FTP.

В настоящее время поддерживается только мгновенный импорт.

Моментальный GET-запрос ImportToListTasks возвращает текущий статус импорта (например, все еще в процессе или уже завершился).

Формат запроса

Создает новую задачу импорта в листы подписчиков.

Элементы тега Data:

Элементы тега Source:

Элементы тега Target:

Элементы тега ImportSetup:

Поддерживаемые режимы импорта

Элементы тега Column:

*Для импорта в стандартные поля (такие как «Email» или «Firstname») необходим элемент Field. Если вы хотите импортировать данные в дополнительные поля, вы можете использовать элемент Field и использовать имя дополнительного поля или элемент Property, если вы предпочитаете работать с дополнительными полями по ID. Оба варианта возможны. ID дополнительных полей вы можете найти в веб-панели ExpertSender.

Список стандартных полей:

Ответ

Метод возвращает ID запланированного импорта. Этот ID может быть использован для получения статуса импорта, используя GET-запрос.

Элементы тега Data в ответе:

Примеры

Импорт подписчиков в лист рассылки с опциями по умолчанию

Запрос:

POST https://api.esv2.com/v2/Api/ImportToListTasks HTTP/1.1 
Accept-Encoding: gzip,deflate 
Content-Type: application/xml 
User-Agent: Jakarta Commons-HttpClient/3.1 
Host: api.esv2.com 
Content-Length: 379 
 
 
 <ApiRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <ApiKey>Ваш_API_ключ</ApiKey>
   <Data>
     <Source>
       <Url>ftp://ftp.expertsender.com/Lists/test.csv</Url>
     </Source>
     <Target>
       <Name> Тестовый импорт по API </Name>
       <SubscriberList>80</SubscriberList>
     </Target>
   </Data>
 </ApiRequest>

Ответ:

HTTP/1.1 201 Created 
Cache-Control: private 
Content-Type: text/xml; charset=utf-8 
Server: Microsoft-IIS/7.5 
X-AspNetMvc-Version: 3.0 
X-AspNet-Version: 4.0.30319 
X-Powered-By: ASP.NET 
Date: Tue, 27 Mar 2012 12:40:14 GMT 
Content-Length: 147 
 
 
 <ApiResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Data>24</Data>
 </ApiResponse>

Импорт подписчиков в лист рассылки с полными опциями

Запрос:

POST https://api.esv2.com/v2/Api/ImportToListTasks HTTP/1.1 
Accept-Encoding: gzip,deflate 
Content-Type: application/xml;charset=UTF-8 
User-Agent: Jakarta Commons-HttpClient/3.1 
Host: api.esv2.com 
Content-Length: 1210 
 
 
 <ApiRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <ApiKey>Ваш_API_ключ</ApiKey>
   <Data>
     <Source>
       <Url>ftp://ftp.expertsender.com/Lists/test.csv</Url>
       <Username>Имя пользователя</Username>
       <Password>Пароль</Password>
     </Source>
     <Target>
       <Name>Тестовый импорт по API </Name>
       <SubscriberList>80</SubscriberList>
     </Target>
     <ImportSetup>
       <Mode>AddAndUpdate</Mode>
       <Delimiter>,</Delimiter>
       <Quote>"</Quote>
       <Escape>"</Escape>
       <Comment>|</Comment>
       <Encoding>UTF-8</Encoding>
       <StartingLine>1</StartingLine>
       <Mapping>
         <Column>
           <Number>0</Number>
           <Field>Firstname</Field>
         </Column>
         <Column>
           <Number>1</Number>
           <Field>Lastname</Field>
         </Column>
         <Column>
           <Number>2</Number>
           <Field>Email</Field>
         </Column>
         <Column>
           <Number>3</Number>
           <Property>94</Property>
         </Column>
         <Column>
           <Number>4</Number>
           <Field>age</Field>
         </Column>
       </Mapping>
     </ImportSetup>
   </Data>
 </ApiRequest>

Импорт с синхронизацией:

<ApiRequest  xmlns:xs="http://www.w3.org/2001/XMLSchema"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <ApiKey>Ваш_API_ключ</ApiKey>
   <Data>
     <ImportSetup>
       <Mode>Synchronize</Mode>
     </ImportSetup>
     <Target>
       <Name>Тестовый импорт</Name>
       <SubscriberList>123</SubscriberList>
     </Target>
     <Source>
       <Url>ftp://domain.com/somefile.csv</Url>
       <Username>Имя пользователя</Username>
       <Password>Пароль</Password>
     </Source>
   </Data>
</ApiRequest>