EasyEcom API modifications V2.1

EasyEcom API modifications V2.1

We are modifying our authorization module for API access. Two new headers are being introduced:
  1. JWT Token
  2. X-API-Key

22 July 2023 onwards, all EasyEcom API can only be accessed by passing both parameters in request headers. Failing to provide that token, the user will not be allowed to access the API and will receive HTTP code 401.

You can access our API documentation at https://api-docs.easyecom.io which now reflects a new method of authorizing your requests

1. JWT Token

To generate a JWT token, refer to the Authorization section in the API documentation

Jwt_token generated by the above method needs to be passed in the header for subsequent API calls 'Authorization: Bearer <jwt_token>'.

This token will be valid for 90 days and the new token can be generated by calling the above API again.

2. X-API-Key

Steps to generate X-API-key 

  1. Log in to easyecom.io primary account. X-API-Key can only be generated from the primary account of the seller.
  2. Go to Account Settings > Change credentials
  3. Under X-API-KEY section, click on Generate X-API-KEY button
  4. Sample Token : 681d976c3bkgkjg6577754lkh46dc8927366eee4

Below is a sample curl request which uses both the mandatory headers: 

curl --location --request GET 'https://api.easyecom.io/<endpoint>' 

--header 'x-api-key: 40e18be2xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx’

--header 'Authorization: Bearer  eyJ0eXAiOiJKV1QiLCJhbGciOixxxxxxxxxxxxxxxxxxxxx’

--header 'Content-Type: application/json'


Rate Limiting

All clients using EasyEcom APIs will experience rate limiting at the X-API-Key level. 
Please refer to the table below for detailed rate limiting tiers:


Initially the Newly generated X-API Key will be created under Default tier for enabling the User to conclude the Testing,
Once the Client level Testing is completed, Our Integration Team will hold a review session, 
Please share the below details for the UAT review:
  1. Flow Diagram
  2. Implemented Touchpoints for Integration in the below format with exact APIs consumed against all use cases/Touchpoints:
    TouchpointsSub-CategorySource DestinationActionDescription
    Major Touchpoint:
    Product/ Inventory/Order Data    		Detailed category of touchpoint wrt against any specific Use caseExact API/Webhook Used with the GET/ POST ImplementationSome details regarding the implementation of the given API along with Below details: Trigger setup: Cron/Real time
Post successful review process the X-API Tier will be upgraded.

Please Note:  The API limiting till Bronze tier is Free of cost,
Any request to increase the Rate limit beyond the Bronze tier will Incur additional commercial scope for Tier upgradation,

Once the allowed quota is consumed, HTTP Code 429 Too Many Requests will be responded to by API. 


    • Related Articles

    • Integrating Marketplace using EasyEcom Standard APIs

      You can easily integrate your marketplace with EasyEcom by following the process explained in this video and/or the integration workflow document shared with you.  Marketplace Integration Frequently Asked Questions  1. Do we need to add carrier ...

    • Integrating Grow Simplee with EasyEcom

      By following the below-mentioned procedure you can easily integrate Grow Simplee with EasyEcom.  Step 1: In the toggle menu, navigate to “Masters>>Carrier Master” Step 2: Click on the “Add New” button Once you click on Carrier Master you will be ...

    • How does EasyEcom work?

      As soon as you sign-up your account with EasyEcom and Integrate all your channels you will be amazed to see how EasyEcom can make your operations very much simple and stressless. It helps you to perform activities related to the Order process, Stock ...

    • EasyEcom Pricing

      Now that you have decided to go ahead with the EasyEcom paid plan one must wonder which pricing might be the best-fit business operation. You might check the various pricing slabs that EasyEcom offers by clicking here. There are various factors that ...

    • How does EasyEcom free trial work?

      Once you have created your business account with EasyEcom, you are entitled to take advantage of EasyEcom’s free trial without any question asked. For this free trial, you are not required to provide your credit card or bank details, unlike our ...