Import Pass Templates
The Import Pass Templates API imports pass templates from a zip file of compressed JSON files. For information about the structure of the JSON files see JSON Files for Import and Export.
This API first checks if the format of the file is correct and then performs the data insert. After this API is executed, the return message only indicates whether or not the format of the file is correct. Use the returned ID to call the Get File Upload Status by ID API to get the status of the import. To view the list of errors that may have occurred during the import, call the Get File Errors By Pagination API.
URL
The HTTP URL for the Import Pass Templates API is:
http://<host>:<port>/api/v1/templates/pass/import
This API is secure and implements Gateway Filter for Authentication/Basic Authentication to authenticate access of the API by a user.
Method
POST
Because this API uploads a file, you must use the "multipart/form-data" encoding format. You must also provide the following request headers with the request.
- file (which points to the name of the file that is uploaded)
- importType: The possible values for importType are:
- insert - This option reads the data in the zip file and attempts to perform an insert. If the insert fails, an error is thrown.
- upsert - This option reads the data in the zip file and attempts to perform an update of each record. If the update fails, the record is inserted.
- delsert - This option deletes all existing data and performs an insert of the data in the zip file. It is strongly recommended that you back up your data before choosing this option.
Header
To invoke this API, the following requested headers with the corresponding values must be passed.
Content-Disposition: form-data; file: PassTemplates.zip
Content-Type: application/x-zip.compressed
The payload's request header includes Content-Type as multipart/form-data.
Input Parameters
The required headers are:
Content-Disposition: form-data; file: PassTemplates.zip
Content-Type: application/x-zip.compressed
Output Parameters
The following fields are output parameters:
Output Parameter | Type | Description |
---|---|---|
message | string | Message associated with response status code |
id | long | File upload ID |
Call the Get File Upload Status by ID API using the returned ID as the input parameter to verify the status of the import. This API will also provide additional error information if the import failed.
Sample Response
{
"message":"File uploaded successfully. Import is in progress.",
"id" : "4855568447645532159"
}
Response Status
Code | Description |
---|---|
Status 200 | Successful upload of file for processing |
Status 400 | Bad request |
Status 401 | Unauthorized request |
Status 500 | Failed to import the data |