Emporix API

Get familiar with Emporix API.

API Quickstart

Download API references:

Download all Emporix API Specs - ZIP

For easier testing of Emporix API, check out the Postman Collection with example flows:

Emporix Commerce Orchestration PlatformPostman

Introduction

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:

• OAuth 2.0 token-based authorization
• Resource-oriented URLs
• HTTP request methods
• JSON-encoded requests and responses
• HTTP status codes

You can check the current status of Emporix API services on the Emporix Status Page.

Base URL

https://api.emporix.io

To start working with our API, make sure to allowlist the api.emporix.io IP: 34.128.182.253.

Authentication and authorization scopes

The Emporix API incorporates OAuth 2.0 token-based authorization. API keys are used to generate access tokens, which are then used to authorize HTTP methods.

To get familiar with the authentication and access scopes, refer to the Tokens and Scopes guide.

Customer audit logs

You can request customer audit logs from Emporix by reaching out to our Support Team and sending the email request. The logs are kept for the last 712 days. 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.

Quick start guide for developers

Before you start

Make sure you have an account on the Emporix Developer Portal.

Retrieve your Emporix API keys

To access the Emporix API, you first need to retrieve your API keys. Perform the following steps:

1

Log in to the Emporix Developer Portal.

2

Go to the Manage API Keys tab and copy the Client ID and Secret values from the Emporix API.

3

Authenticate and authorize yourself by obtaining the service token. See more details in the OAuth Service Tutorial. For example:

curl --location --request POST 'https://api.emporix.io/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={{Client_ID}}' \
--data-urlencode 'client_secret={{Client_Secret}}'

4

Send a sample request. For example, create a basic product:

curl -L \
  --request POST \
  --url 'https://api.emporix.io/product/{tenant}/products' \
  --header 'Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Smartphone X2",
    "code": "BASIC001",
    "description": "The world best camera and camcorder in a waterproof smartphone.",
    "published": false,
    "productType": "BASIC"
  }'

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.

Explore the Emporix API

You're all set! You can now interact with the Emporix API.