Rate limiting is basically limiting traffic on various components of the system that is commonly used in the provision of software services in B2C or B2B. The purpose of this limiting 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 transferring the meaning to normal road traffic, where vehicles are limited in speed or number of passes on certain road sections to increase safety and improve traffic flow.
To whom do the limits apply?
When integrating to the MALL Partner system, it is therefore necessary to observe the following rules, which are applied to the use of system calls on the API interface. In particular, those of you who use API connections should apply these rules when creating connections from your ERP or eshop system. However, the limit is also used by those of you who have, for example, installed an add-on from our catalogue or you're working with another one of your integrators. Simply put, your primary type of connection to MALL Partner does not necessarily determine whether or not the limits apply to you, the determining factor in this case is purely whether or not you use the API integration with our system in any way.
What limits does MALL Partner apply?
We have divided the API limits into the following logical units to reflect the normal operation of online sales, based on the needs of our partners.
1) Product Listing
- creation, update, activation and deletion of products (including stock availability updates if sent as a product update)
- endpoints: /v1/products/*
2) Stock availability update
- update the number of items in stock (BATCH method)
- endpoints: /v1/availability/*
3) Order management
- e.g. updating statuses, getting order details
- endpoints: /v1/orders/*
4) Other
- e.g. finding information about categories and their parameters or downloading
- endpoints: all remaining endpoints of the system not specified in the previous points
Each of these units is subject to a daily maximum call limit at specified levels according to the number of products you have on file with us.
However, in addition to the daily limit, the system also applies maximum limits in shorter time periods - hourly and minute windows.
The hourly window is set at half the daily limit.
The minute window is set to 15 000 requests/minute.
Current call limits at each level
Limits are refreshed every day at 0:00
| ESSENTIAL | PLUS | PROFESSIONAL | Endpoints | |
| Number of products/variants of the partner in DB (product article)* | up to 5 000 | up to 50 000 | over 50 000 | |
| Product Listing | 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 reg./hour | All other API endpoints |
req. = request, i.e. call to API endpoint
*each variant counts as a separate sales item
Where can you find the current status of your limit?
V the MALL Partner portal we have prepared a new tab where you can find information about the current status and results for the previous day.
On the tab, you will also find information about your classification to a specific level, which further defines the allowed limits.
How to integrate MALL Partner correctly 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 set of Best practice tips for integration.
For further questions on how best to connect or to increase your current level, please contact us via Help Centre.
Please note that limit increases are strictly based on your number of products, taking into account your number of orders.
Other connection types
Even for other types of connections, such as MALL feed and Heureka feed, you need to observe the limit of the daily number of updates/requests that your feed generates, corresponding to the number of products in the feed according to the table above. If the daily number of updates exceeds the allowed limit, the frequency of play may be limited. In extreme cases, the feed may be stopped completely to protect the health of the platform.