GET /feed/import

Scope

api_ro or console_ro

Accept

application/sellside.feedimport.list-v1+json, application/json

This URL returns the feed imports of the current user in descending chronological order. By default, only the last 10 imports are retrieved but this number can be controlled via the limit parameter (< 100).

Feed imports are triggered automatically by the system once per day or on demand by Customer Service agents. Each feed import object contains the time when it was started (dateCreated), the URL of the user’s XML document (url) and whether the document could successfully be processed (status). The status field contains DONE when the document was processed correctly, PENDING - when it is currently being processed or REJECTED - when it was either not accessible or syntactically incorrect. In the latter case, the field error contains a descriptive error message.

The feed import object also contains counters to denote the total number of ads specified in the XML document (totalCount), the number of ads which were processed without errors (okCount), the number of ads which were processed with warnings (warningCount) and the number of ads which were rejected due to errors (errorCount).

Note

The field totalCount is set to -1 when the XML document could not be processed (status = REJECTED)

Each feed import contains an id field which can be used to query for more information regarding the erroneous ads in the XML document via GET /feed/import/{id}/detail.

Errors

Field

Code

Error message

Description

limit

2001

invalid argument

not a valid number

limit

2002

out of range

less than 1 or greater than 100

Example

GET /api/sellside/feed/import
Accept: application/sellside.feedimport.list-v1+json; application/json

200 OK
Content-Type: application/sellside.feedimport.list-v1+json; charset=UTF-8

[
  {
    "id":           5,
    "url":          "http://ourshop.com/feed.xml",
    "status":       "DONE",
    "dateCreated":  "2016-02-03T15:35:33Z",
    "error":        "",
    "totalCount":   2,
    "okCount":      1,
    "warningCount": 1,
    "errorCount":   0
  },
  {
    "id":           4,
    "url":          "http://ourshop.com/notfound.xml",
    "status":       "REJECTED",
    "dateCreated":  "2016-02-03T15:35:23Z",
    "error":        "HTTP 404 Not Found for: http://ourshop.com/notfound.xml",
    "totalCount":   -1,
    "okCount":      0,
    "warningCount": 0,
    "errorCount":   0
  }
]