API Limits - What is a rate limiter? - MALL Partner

Rate limiting is basically the restriction of traffic on various components of the system, which is commonly used in the provision of software services in B2C or B2B. The purpose of this limitation is primarily to streamline 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 the transfer of meaning to normal road traffic, where vehicles are limited by speed or number of passes on certain sections of the road in order to increase safety and improve traffic flow.

To whom do the limits apply?

When integrating into the MALL Partner system, it is therefore 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 connection API should apply these rules when creating a connection from your ERP or e-shop system. However, the limit is also used by those of you who have, for example, an installed accessory from ours catalog or you work with another of your 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 decisive factor in this case is whether you use API integration with our system in any way.

What limits does MALL Partner apply?

In connection with the needs of our partners, we have divided the API limits into the following logical 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

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

3) Order management

eg status updates, obtaining order details
endpoints: / v1 / orders / *

4) Others

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

The daily maximum call limit in the specified levels is applied to each of these units according to your number of products that you have listed with us.
However, in addition to the daily limit, the system also applies maximum limits in shorter time periods - hour and minute window.
The hour window is set as half of the daily limit.
The minute window is set at 15,000 requests / minute.

Current call limits in 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 rpm	/ 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 rpm	/ v1 / orders / *
Other	5,000 req./day 2,500 rpm	5,000 req./day 2,500 rpm	5,000 req./day 2,500 reg./hour	All other API endpoints

req. = request, ie call to API endpoint

* each variant counts as a separate sales item

Where can you find the current status of your limit?

IN MALL Partner of the portal we have prepared a new tab for you, on which you will find information about the current status and results for the previous day.

On the tab, you will also find information about your inclusion in a specific level, which further defines the permitted limits.

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

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

If you have more questions about how to best connect or need to increase your current level, contact our onboarding team onboarding@mallgroup.com.

Please note that the increase in limits is strictly governed by your number of products, taking into account your number of orders.