Rate limiting to po prostu ograniczenie ruchu na różnych komponentach systemu, rozwiązanie powszechnie stosowane przy świadczeniu usług programistycznych w B2C lub B2B. Głównym celem tego ograniczenia jest poprawa jakości integracji naszych partnerów w celu zwiększenia stabilności i czasu reakcji systemu MALL Partner. Z punkt widzenia przeciętnego użytkownika, funkcjonalność można wyjaśnić poprzez porównanie jej do ruchu drogowego, w którym stosuje się ograniczenia prędkości lub limitu przejazdów na pewnych odcinkach drogi w celu poprawy bezpieczeństwa i płynności ruchu.
Kogo dotyczą ograniczenia?
Podczas integracji z systemem MALL Partner konieczne jest przestrzeganie poniższych zasad, które dotyczą korzystania z wywołań systemowych do interfejsu API. Szczególnie ci z państwa, którzy korzystają z połączenia API powinni stosować te zasady przy tworzeniu połączenia z państwa systemu ERP lub e-sklepu do systemu MALL. Limit ten jest również stosowany dla tych z was, którzy zainstalowali dodatek z naszego katalogu lub współpracują z innymi integratorami. Mówiąc prościej, twój podstawowy rodzaj połączenia z MALL nie musi decydować o tym, czy limity dotyczą Ciebie, czy nie. Czynnikiem decydującym jest to, czy w jakikolwiek sposób korzystasz z integracji API z naszym systemem.
Jakie limity obowiązują w MALL Partner?
Wychodząc naprzeciw potrzebom naszych Partnerów, podzieliliśmy limity API tak, aby odpowiadały standardowemu funkcjonowaniu sprzedaży online:
1) Przeglądanie produktów
- tworzenie, aktualizowanie, aktywacja i usuwanie produktów (w tym aktualizacja dostępności towaru, jeśli przesyłana jako aktualizacja produktów)
- endpointy: /v1/products/*
2) Aktualizacja dostępności produktów
- aktualizacja liczby pozycji w magazynie (metoda BATCH)
- endpointy: /v1/products/*
3) Zarządzanie zamówieniami
- aktualizacja statusu, uzyskanie szczegółów zamówienia itp.
- endpointy: /v1/orders/*
4) Inne
- wyszukiwanie informacji o kategoriach i ich parametrach lub ich pobieranie etc.
- endpointy: wszystkie pozostałe endpointy systemu nie wymienione w poprzednich punktach
Każda w wymienionych grup objęta jest dziennym maksymalnym limitem wywołań na określonych poziomach uzależnionych od ilości posiadanych produktów.
Oprócz limitu dziennego, system stosuje także limity maksymalne w krótszych przedziałach czasowych: na godzinę, na minutę.
Limit godzinowy jest ustawiony jako połowa limitu dziennego.
Limit minutowy jest ustawiony na 15 000 żądań/min.
Aktualne limity połączeń dla poszczególnych poziomów
Limity są resetowane codziennie o godzinie 0:00.
ESSENTIAL | PLUS | PROFESSIONAL | Endpoints | |
Liczba produktów/wariantów partnera w DB (product article)* | do 5 000 | do 50 000 | ponad 50 000 | |
Przeglądanie produktów | 2 000 req./dzień 1 000 req./godz. | 40 000 req./dzień 20 000 req./godz. | 100 000 req./dzień 50 000 req./godz. | /v1/ products/* |
Aktualizacja dostępności produktów | 1 000 req./dzień 500 req./godz. | 2 000 req./dzień 1 000 req./godz. | 5 000 req./dzień 2 500 req./godz. | /v1/availability/* |
Zarządzanie zamówieniami | 7 500 req./dzień 3 750 req./godz. | 7 500 req./dzień 3 750 req./godz. | 25 000 req./dzień 12 500 req./godz. | /v1/orders/* |
Inne | 5 000 req./dzień 2 500 req./godz. | 5 000 req./dzień 2 500 req./godz. | 5 000 req./dzień 2 500 req./godz. | Pozostałe endpointy API |
req. = żądanie, wywołanie punktu końcowego API.
* każdy wariant liczy się jako osobna pozycja sprzedaży
Gdzie mogę znaleźć aktualny stan mojego limitu?
Przygotowaliśmy dla Ciebie nową zakładkę w portalu MALL Partner, w której znajdziesz informacje o aktualnym stanie limitu oraz stan zużycia za dzień poprzedni.
Znajdziesz tam również informację o zakwalifikowaniu Cię do określonego poziomu oraz przypisanych do niego limitach.
Jak prawidłowo zintegrować się z MALL Partner i co zrobić, gdy mój limit jest niewystarczający?
W celu lepszego zrozumienia procesu integracji z naszym systemem, zachęcamy do zapoznania się z poradnikiem: Jak prawidłowo podłączyć MALL Partner API.
W przypadku dalszych pytań na temat tego, jak najlepiej się połączyć lub zwiększyć swój obecny poziom, prosimy o kontakt poprzez Centrum Pomocy.
Proszę pamiętać, że zwiększenie limitów jest ściśle uzależnione od liczby produktów, przy jednoczesnym uwzględnieniu liczby zamówień.