Imports (Upload Inventory File)

Imports (Upload Inventory File)

Name

Imports

Description

Upload an inventory file (CSV or TSV) for processing

Type

POST

URL

/imports Note the lack of version identifier in the URI

Credential Type

Upload

Long Description

This endpoint is used to upload your TSV or CSV inventory file to us for processing if you are not already using our Auto Uploader software. See the Import File Specification to see how to create your import file.

 

This endpoint is very different than the other endpoints and differs in the following ways:

  • Does not have an API version identifier in the URI

  • Uses an Upload credential instead of the standard API credential

  • Does not use the HMAC-based X-Signature header

  • Uses an Authentication-Token header

 

Parameters

Name

Description

Value Type

Presence

Name

Description

Value Type

Presence

data

The inventory file to upload

File

Required

 

Generally speaking, HTTP status codes are used appropriately for each response.

HTTP Status Code

Description

HTTP Status Code

Description

200 OK

Authentication success, when data is not sent

202 Accepted

Authentication success, when data is sent

401 Unauthorized

Authentication failure

422 Unprocessable Entity

Validation failed for the given input. Something is wrong in your file.

 

Examples

Request (cURL)

Response

Request (cURL)

Response

curl -i \ -H 'Authentication-Token: af3d2fe2b94b02d5b993a615dba33111' \ -F data=@file.csv \ --url 'https://api.ticketevolution.com/imports'

 

 

HTTP/1.1 202 Accepted Content-Type: text/html; charset=utf-8 Transfer-Encoding: chunked Connection: keep-alive Status: 202 Accepted Cache-Control: no-cache X-UA-Compatible: IE=Edge,chrome=1 X-Runtime: 0.043110 Date: Tue, 02 Feb 2016 00:10:43 GMT