Перейти к содержимому

Get subscriber import progress

Request data format

Request URL parameters:

Element/attributeTypeNotes
apiKeystringYour API key, required for authentication. Required.
IDintegerImport ID. Required as a part of address (not GET parameter). See example below.

Example URL:

https://api.esv2.com/v2/Api/ImportToListTasks/19?apiKey=test_api_key1

Response

Method returns an object describing the scheduled import and its execution history.

Response Data element:

Element/attributeTypeNotes
NamestringImport task name.
ListstringName of list subscribers will be imported to.
UrlstringURL address of file containing imported subscribers.
Historyarray[complex]Array of Import elements describing import executions.*

*History may be empty if import was never executed.

Import element children:

Element/attributeTypeNotes
StartedAtdateTimeDate of import start.
UpdatedAtdateTimeDate of last import status change.
StatusstringImport status. One of: «Queued», «InProgress», «Completed», «Error», «Warning».
DetailsstringAdditional information, e.g. error info if import failed.

Examples

Request:

GET https://api.esv2.com/v2/Api/ImportToListTasks/19?apiKey=test_api_key1 HTTP/1.1 
Accept-Encoding: gzip,deflate 
User-Agent: Jakarta Commons-HttpClient/3.1 
Host: api.esv2.com

Response:

HTTP/1.1 200 OK 
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: Thu, 05 Apr 2012 15:50:13 GMT 
Content-Length: 559  

<ApiResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Data>
     <Name>API test import</Name>
     <List>API test list</List>
     <Url>ftp://ftp.expertsender.com/Lists/test.csv</Url>
     <History>
       <Import>
         <StartedAt>2012-03-27T11:01:18</StartedAt>
         <UpdatedAt>2012-03-27T11:01:27</UpdatedAt>
         <Status>Completed</Status>
         <Details>ftp://ftp.expertsender.com/Lists/test.csv</Details>
       </Import>
     </History>
   </Data>
</ApiResponse>
On this page
To top