Emporix API
Last updated
Was this helpful?
Last updated
Was this helpful?
The Emporix API is the core of our Commerce Engine designed to help you easily manage your business's resources. It is organized around REST and makes use of the following components:
token-based authorization.
Resource-oriented URLs.
.
JSON-encoded requests and responses.
.
You can check the current status of Emporix API services on the .
To start working with our API, make sure to allowlist IP: 34.128.182.253.
The Emporix API incorporates token-based authorization. API keys are used to generate access tokens, which are then used to authorize HTTP methods.
The Emporix Developer Portal provides you with two types of credentials:
Emporix API — used to access the API from a business owner's perspective.
Storefront API — used to access the API from a customer's perspective. These credentials are used to perform basic actions on the storefront — browse products, view prices, or add products to a cart.
When using our API, you will come across four types of access tokens:
Anonymous token
Used by the storefront to access public resources with a reading scope. It allows customers to browse products, view prices, or add products to a cart. The anonymous token is not associated with any specific customer.
Customer token
A JSON Web Token (JWT) which contains encrypted customer data. The customer token works similarly to the anonymous token, but it is associated with a specific customer.
Refresh token
Used to refresh the customer token.
Service access token
Needed to access and manage the Emporix services such as adding new products, managing categories, or modifying prices.
When you request an access token, you can see a scope field in the response. Scopes define which operations you are allowed to perform and which resources you can access.
The overall naming convention for scopes is [service_name].[resource_name]_[action_name].
The action names read and view are used interchangeably and both mean that the scope grants read-only access to a particular resource.
Anonymous, customer, and refresh tokens have a pre-defined set of scopes. You can request specific scopes only when requesting a service access token. To find out which scopes are needed to access a particular endpoint, check its description in the Emporix API Reference.
Some endpoints do not require any scopes as they are implicitly readable.
To access the Emporix API, you first need to retrieve your API keys. Perform the following steps:
Go to the Manage API Keys tab.
Copy the Client ID and Secret values from the Emporix API row.
You should receive your main site's settings in the response body.
If you want to send a request to an endpoint that requires a different set of scopes, you need to generate a new access token.
You're all set! You can now interact with the Emporix API.
You can request customer audit logs from Emporix by reaching out to our and sending the email request. The logs are kept for the last 2 years. You can retrieve information about create, update or delete operations. The records contain information about the tenant, timestamp and the person who performed the actions.
Make sure you have an account on the .
Log in to the .
You can now use your Emporix API keys to authorize requests. Try it out by calling the endpoint: