Library Push is where an image is loaded into the Library via a direct upload. Uploading an image to the Library automatically creates a unique link which can be used to direct the user to the Product Builder.
Requires:
- Internal or External User Token (to associate the Library Item with the User)
or
- API Key or Application Token (to create an Anonymous User and associate the Library Item)
Actions
| URL | Verb | Information |
|---|---|---|
| /library/push | POST | Creates a Library item |
Fields
The requests to the Library push actions should be HTTP multipart file uploads containing one and only one file. Request should set the "Content-Type" HTTP header to "multipart/form-data" and a boundry as standard. Inside the part containing the file contents, the "Content-Type" must be included, specifying the type of the file being uploaded.
The following details are returned about an item:
| Field | Data Type | Required | Information |
|---|---|---|---|
| LibraryItem | LibraryItemDetail | Y | Fields described below. |
| ProductBuilderUrl | String | Y | The product builder URL for the specified Library Item |
The following details are returned about a Library item.
| Field | Data Type | Required | Information |
|---|---|---|---|
| ItemGuid | String | Y | The Guid of the Library item |
| FileMimeType | String | Y | The MIME type of the Library item. |
| FileMd5 | String | N | An MD5 hash of the file contents. Only set if the item is complete. |
| FileSize | Long | N | Length of the file in bytes. Only set if the item is complete. |