Limity API — Co to jest API Limiter?

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ń.

---