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 |
|---|---|---|---|
data | The inventory file to upload | File | Required |
Generally speaking, HTTP status codes are used appropriately for each response.
| 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 |
|---|---|
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 |