uStore API Help

Introduction

The uStore Application Programming Interface (API) is available in the form of REST API. This technology is recommended for use when developing new, custom-made applications and integrations that are based on the uStore platform.

General Information

uStore APIs are accessible using HTTP or HTTPS protocols, depending on the uStore configuration.

APIs receive and return JSON objects. The "Content-Type" header with the "application/json" value should be added to all requests.

In case of an error, all uStore APIs throw an exception, resulting in a "Bad Request" (400) HTTP error received by the client.

Authentication

Each uStore API receives a security token that is used by uStore for authentication and authorization of the caller. The security token is a string generated by the login API that receives the user's email, password and the store’s unique ID, and returns a security token.

The API caller provides the generated security token to other APIs using the HTTP request header:

Header name: Authorization

Header value: uStore [security_token]

The security token can be used for calling APIs for one hour only. After this period, an AccessDenied error is thrown by all APIs that receive the expired security token.

The website/application can always call the logout API. This API receives a security token and releases it. As a result, all APIs that receive a security token that was released throw an AccessDenied exception.

Localization

Most of uStore APIs return results according to the requested localization.

The API caller can provide a localization to any API using the HTTP request header:

Header name: Accept-Language

Header value: [language_code] E.g. "en-US"

If a localization was not provided to an API or it does not exist for the store, then the API will use the store’s setup localization.

The localization used by the API – whether provided by the caller or chosen by the API – is returned in the HTTP response header:

Header name: Content-Language

Header value: [language_code] E.g. "fr-FR"

Asset

API	Description
GET v1/store/login/user/assets	Gets collection of the graphic assets by dial ID.
GET v1/store/login/user/assets/{assetID}	Gets graphic asset detailed data by asset ID.
DELETE v1/store/login/user/assets/{assetID}	Deletes uploaded graphic asset by ID.
POST v1/store/login/user/assets	Uploads graphic asset.

Cart

API	Description
GET v1/store/login/user/orders/cart/items/count	Gets the general cart information of the current user.
GET v1/store/login/user/orders/cart	Gets the general cart information of the current user.
GET v1/store/login/user/orders/wishList	Gets the wish list information of the current user.
POST v1/store/login/user/orders/cart/clear	Clears the cart of the current user.
POST v1/store/login/user/orders/wishList/clear	Clears the wish list of the current user.
GET v1/store/login/user/orders/cart/validations	Validates the cart of the current user.
GET v1/store/login/user/orders/wishList/validations	Validates the wish list of the current user.
GET v1/store/login/user/orders/cart/price	Gets the cart pricing information of the current user.
GET v1/store/login/user/orders/wishList/price	Gets the wish list pricing information of the current user.
PUT v1/store/login/user/orders/cart/{orderItemID}	Updates the item of the cart of the current user.
PUT v1/store/login/user/orders/cart	Updates the items of the cart of the current user.
PUT v1/store/login/user/orders/wishList/{orderItemID}	Updates the item of the wish list of the current user.
POST v1/store/login/user/orders/cart/checkout	Submits the given cart list
POST v1/store/login/user/orders/cart/approval/revert	Reverts user's cart modification.
POST v1/store/login/user/orders/cart/{orderItemID}/duplicate	Duplicates the cart item.
POST v1/store/login/user/orders/cart/lists	Creates new cart list.
GET v1/store/login/user/orders/cart/lists/id	Gets cart list ID be the external ID.
GET v1/store/login/user/orders/cart/lists/{listID}/details	Gets detailed information about cart list by cart list ID.
GET v1/store/login/user/orders/cart/lists	Gets list of the existing user cart lists in the store.
DELETE v1/store/login/user/orders/cart/lists/{listID}	Deletes cart list by ID.
PUT v1/store/login/user/orders/cart/lists/{listID}	Updates cart list data by ID.
POST v1/store/login/user/orders/cart/lists/{listID}/export	Exports cart list data by ID to the 3rd party service that was assigned to the store.
POST v1/store/login/user/orders/cart/lists/{listID}/duplicate	Duplicates cart list by ID.

API	Description
GET v1/store/categories	Gets the top level product categories of a store, using pagination. Categories that do not contain online products on any level are filtered out.
GET v1/store/categories/{categoryID}/categories	Gets the sub-categories of a specific product category, using pagination. Categories that do not contain online products on any level are filtered out.
GET v1/store/categories/id	Gets the category's unique ID by its friendly ID.
GET v1/store/categories/{categoryID}	Gets the category by its unique ID.
GET v1/store/categories/tree	Gets the tree of product categories of a store. Categories that do not contain online products on any level are filtered out.

Orders

API	Description
GET v1/store/login/user/orders/summary	Gets the summary of orders of the currently logged-in user, who is identified by the provided security token.
POST v1/store/login/user/orders/draft/items	Creates a draft order item of a product.
GET v1/store/login/user/orders/unsubmitted/items/{orderItemID}	Gets the order item that has not been submitted by its unique ID.
PUT v1/store/login/user/orders/unsubmitted/items/{orderItemID}	Updates the order item that has not been submitted.
POST v1/store/login/user/orders/unsubmitted/items/{orderItemID}/price/calculate	Gets the price of the order item that has not been submitted.
POST v1/store/login/user/orders/submitted/items/{orderItemID}/reorder	Reorders the submitted order item.
GET v1/store/login/user/orders/submitted/items/last/status	Gets the information about the last submitted order item of a product.
POST v1/store/login/user/orders/unsubmitted/items/{orderItemID}/addToCart	Moves the order item to the user's shopping cart.
POST v1/store/login/user/orders/unsubmitted/items/{orderItemID}/saveForLater	Moves the order item to the user's wish list
DELETE v1/store/login/user/orders/unsubmitted/items/{orderItemID}	Deletes the order item from the Cart, Wish list or Drafts.
GET v1/store/login/user/orders/unsubmitted/items/proof

Products

API	Description
GET v1/store/products/id	Gets the product's unique ID by its friendly ID.
GET v1/store/products/{productID}	Gets the product by its unique ID.
GET v1/store/categories/{categoryID}/products	Gets the online products of a specific product category, using pagination.
GET v1/store/products/search	Gets the products using a search string.
GET v1/store/products	Gets the products by their unique IDs.
GET v1/store/products/{productID}/thumbnails	Gets product thumbnails.

Proof

API	Description
POST v1/store/login/user/orders/unsubmitted/items/{orderItemID}/preview	Creates preview for the dynamic product by order product ID.
GET v1/store/login/user/orders/unsubmitted/items/{orderItemID}/preview/{previewID}	Gets preview status.
GET v1/store/login/user/orders/unsubmitted/items/{orderItemID}/preview/{previewID}/download	Returns binary content of the preview file by file name.
POST v1/store/login/user/orders/unsubmitted/items/{orderItemID}/proof	Creates proof for the dynamic product by order product ID.
GET v1/store/login/user/orders/unsubmitted/items/{orderItemID}/proof/download	Returns binary content of the proof file by file name.

Properties

API	Description
POST v1/store/login/user/orders/unsubmitted/items/{orderItemID}/properties/{propertyID}/files	Appends files to the order item property.
DELETE v1/store/login/user/orders/unsubmitted/items/{orderItemID}/properties/{propertyID}/files	Delete files of the order item property

SingleSignon

API	Description
POST v1/store/sso	Generates single sign-on url
POST v1/store/sso/login	Logs the user into the store using temporary SSO token.

Store

API	Description
POST v1/store/login	Logs the user into the store.
POST v1/store/login/renew	Renews the user session.
DELETE v1/store/login	Logs the user out from the store.
GET v1/store/login/user	Gets the currently logged-in user, who is identified by the provided security token.
PUT v1/store/login/user/preferences	Update or create preferences for user that is currentlly logged-in to the store.
GET v1/store	Gets the store to which the user is currently logged in. The store unique ID and the currently logged-in user are identified by the provided security token.
GET v1/store/cultures	Gets the cultures of the store.
GET v1/store/currencies	Gets the currencies of the store.
GET v1/store/deliveryServices	Gets store's delivery service.
GET v1/store/paymentMethods	Gets store's payment methods.
GET v1/store/countries	Gets the list of countries.
GET v1/store/countries/{countryID}/states	Gets the list of states for the specified country.

System

API	Description
GET v1/system/imageProxy	Gets graphic content for the uStore's entity.
GET v1/system/assetProxy	Gets graphic asset content.

User

API	Description
POST v1/store/login/user/addresses	Adds user's addresses.
PUT v1/store/login/user/addresses/{addressID}	Changes user's addresses.
GET v1/store/login/user/addresses	Gets user's addresses.
GET v1/store/login/user/activities	Provides active tasks of the current user