API Limits - What is the rate limiter?

Rate limiting is basically a restriction of traffic on various components of the system, which is commonly used in the provision of software services in B2C or B2B. The main purpose of this limitation is to improve the integration of our partners in order to increase the stability and response time of the MALL Partner system. For the average user, this functionality can be explained by comparing it to a normal road traffic, where vehicles are limited by speed or number of passes on certain sections of the road in order to improve the safety and the traffic flow. 

Does the limit apply to me? 

When integrating into the MALL Partner system, it is necessary to observe the following rules, which are applied to the use of system calls to the API interface. Especially those of you who use the API connection should apply these rules when creating a connection from your ERP or e-shop system to MALL. However, the limit is also used for those of you who have installed an add-on from our catalog or you are working with some different integrators. Simply put, your primary type of connection to the MALL Partner does not necessarily determine whether the limits apply to you or not. The determining factor is whether you use API integration with our system in any way. 

Which limits are imposed on MALL Partners?

In order to meet the needs of our partners, we have logically divided the API limits into the following units, which should reflect the normal functioning of online sales.

1) Product browsing

• creating, updating, activating and deleting products (incl. stock availability update, if sent as a product update)
• endpoints: /v1/products/*

2) Stock availability update

• updating the number of items in stock (BATCH method)
• endpoints: /v1/availability/*

3) Order management

• status updates, obtaining order details etc.
• endpoints: /v1/orders/*

4) Others

• finding information about categories and their parameters or downloading them etc.
• endpoints: all remaining system endpoints not specified in the previous points

Each of these units is subjected to a daily maximum call limit at a specific level according to the number of your products.
However, in addition to the daily limit, the system also applies maximum limits in shorter time periods - per hour and per minute.
The hourly limit is set as half of the daily limit.
The minute limit is set at 15,000 requests/minute.

Current call limits by individual levels

Limits are updated every day at 0:00

	ESSENTIAL	PLUS	PROFESSIONAL	Endpoints
Number of partner products / variants in DB (product article) *	up to 5,000	up to 50,000	over 50,000
Product browsing	2,000 req./day 1,000 req./hour	40,000 req./day 20,000 req./hour	100,000 req./day 50,000 req./hour	/v1/ products/*
Stock Availability	1,000 req./day 500 req./hour	2,000 req./day 1,000 req./hour	5,000 req./day 2,500 req./hour	/v1/availability/*
Order management	7,500 req./day 3,750 req./hour	7,500 req./day 3,750 req./hour	25,000 req./day 12,500 req./hour	/v1/orders/*
Other	5,000 req./day 2,500 req./hour	5,000 req./day 2,500 req./hour	5,000 req./day 2,500 req./hour	All other API endpoints

req. = request, that is calls to API endpoint

* each variant counts as a separate sales item

Where can I find the current state of my limit?

We prepared a new tab in theMALL Partner portal where you will find information about the current limit state and results for the previous day.

Here you can also find information about your placement in a specific level, which further defines the allowed limits.

How to properly integrate a MALL Partner and what if my limit is not enough?

For a better understanding of how to effectively integrate the connection to our system, we have prepared a file Best practice tips for integration.

For further questions on how best to connect or to increase your current level, please contact us via FAQ.

Please note that the increase in limits is strictly based on your number of products while also taking the number of orders into account.

---