REST API Hummerce udostępnia dane sklepu w formacie JSON - towary, kategorie, strony, klientów, zamówienia, widoki i inne obiekty - do integracji z ERP, hurtowniami, porównywarkami cen czy własnymi narzędziami. To podstawowy sposób połączenia sklepu z systemami zewnętrznymi, obok integracji gotowych (np. Allegro, Microsoft Dynamics NAV, Comarch ERP XL) i asystenta AI (MCP).
Stan na wersję Hummerce 2.35.66, aktualizacja 2026-10-07.
- Jeden standard integracji dla wielu systemów zewnętrznych - ERP, hurtownie, porównywarki, własne aplikacje - bez pisania integracji od zera dla każdego z nich.
- Pełen dostęp do danych sklepu z poziomu obsługi - te same obiekty i uprawnienia, co w panelu administracyjnym.
- Dowolny zakres uprawnień - od pełnego dostępu administratora po konto ograniczone tylko do wybranych obiektów i operacji.
- Kontrola nad danymi zamówień i towarów w czasie rzeczywistym - system zewnętrzny odpytuje sklep bezpośrednio, bez plików pośrednich i opóźnień importu wsadowego.
REST API udostępnia:
- Towary - w tym warianty i sloty zestawów konfigurowalnych. Kategorie towaru można ustawić przy zapisie, także dla wariantu - patrz niżej.
- Kategorie.
- Strony.
- Klientów.
- Widoki - odczyt, tworzenie, zmiana i usuwanie widoku, a operacje na innych obiektach można wykonać w kontekście wskazanego widoku.
- Zamówienia.
- Rodzaje i lokacje parametrów.
- Producentów.
- Magazyny i wpisy magazynowe (stany).
- Zwroty - tylko po stronie zaplecza sklepu (obsługa reklamacji w panelu), bez zgłaszania zwrotu przez klienta w sklepie przez API.
- Inne obiekty sklepu (repozytoria) - np. kupony, bannery, dane z formularzy, opinie, wpisy książki adresowej.
- Moduł REST API trzeba włączyć w sklepie - nie jest aktywny domyślnie.
- Dostęp nadaje się kontu administratora panelu: pełne uprawnienia administratora albo uprawnienia ograniczone tylko do wybranych obiektów i operacji API.
- Parametry, które mają być widoczne w odpowiedziach API, przypisuje się do dedykowanych lokacji - osobno dla towarów, kategorii, stron, klientów, widoków i zamówień.
- Adres, pod którym działa API konkretnego sklepu, oraz dane dostępowe ustala się przy wdrożeniu.
- Przy zapisie towaru można wskazać kategorię główną i dodatkowe kategorie. Od wersji 2.35.66 działa to także dla wariantów (podtowarów) - wcześniej API pomijało kategorie, gdy w towarze podano towar nadrzędny.
- Kategoria główna wariantu zapisuje się zawsze. To, czy wariant pojawi się na listach tej kategorii w sklepie, zależy od ustawienia sklepu Warianty towarów na listach - tak samo jak przy zmianie kategorii w panelu.
- Towar bez kategorii głównej nie powoduje już błędu przy zmianie jego kategorii.
- Standard REST, dane w formacie JSON.
- Filtrowanie i sortowanie zależnie od obiektu, m.in. po dacie modyfikacji.
- Parametr zapytania pozwala ustawić format daty zwracanej w odpowiedzi, nadrzędnie wobec domyślnego ustawienia sklepu.
REST API i serwer MCP (asystent AI) to dwa niezależne sposoby połączenia się ze sklepem, oparte o te same uprawnienia kont administratorów:
- REST API - do integracji systemowej: ERP, hurtownie, porównywarki, własne skrypty i aplikacje wywołujące konkretne metody.
- Asystent AI (MCP) - do pracy zespołu obsługi poleceniami w języku naturalnym, z ograniczonym zestawem gotowych narzędzi (nie każdy obszar REST API ma odpowiednik w MCP i odwrotnie - np. cenniki są zapisywalne przez MCP, ale nie przez REST API).
- Magazyny i wpisy magazynowe w API - od wersji 2.31.
- Zwroty w API (tylko zaplecze) - od wersji 2.35.
- Kategorie przy zapisie wariantów (podtowarów) - od wersji 2.35.66.
- REST API jest rozwijane sukcesywnie o kolejne obiekty sklepu wraz z kolejnymi wersjami platformy.
- Moduł REST API włączony w sklepie.
- Konto administratora z uprawnieniami do obiektów i operacji udostępnianych przez API.
- Parametry przypisane do lokacji API (osobno dla towarów, kategorii, stron, klientów, widoków, zamówień), jeśli mają być widoczne w odpowiedzi.
- Wymaga wdrożenia - moduł nie jest włączony domyślnie. Zakres typowego uruchomienia:
- włączenie modułu REST API,
- założenie konta i uprawnień dedykowanych do integracji,
- wskazanie parametrów w lokacjach API dla integrowanych obiektów,
- testy wywołań z systemem docelowym.
- Minimalny szacowany czas:
- integracja jednego obszaru (np. tylko zamówienia albo tylko towary) - od 8 h,
- szerszy zakres (kilka obszarów, mapowanie pól po stronie systemu zewnętrznego) - od 16 h,
- zawsze doliczamy: analiza - +1 h, testy - +2 h, wdrożenie produkcyjne - +1 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- liczba integrowanych obszarów danych,
- złożoność mapowania pól po stronie systemu zewnętrznego,
- niestandardowy zakres uprawnień konta API,
- wersja sklepu - starsza wersja wymaga najpierw aktualizacji (wycena osobno).
- Brak operacji na cennikach - ceny ustawia się importem z Excela albo przez asystenta AI.
- Brak obsługi kont firmowych (B2B).
- Kategoria wariantu zapisana przez API nie sprawia, że wariant widać na listach kategorii, jeśli sklep ma wyłączone ustawienie Warianty towarów na listach.
- Brak operacji na ofertach Allegro - to osobna integracja.
- Uprawnienia do obiektów nie zawsze rozdzielają odczyt i zapis oddzielnie - zależy to od obiektu.
- Zwroty w API obejmują tylko zaplecze sklepu, bez zgłaszania zwrotu przez klienta w sklepie przez API.
- REST API nie ma wbudowanego limitu zapytań na minutę (w przeciwieństwie do serwera MCP) - zbyt intensywne wywołania mogą spowolnić sklep. Przy wdrożeniu zalecamy stopniowe zwiększanie obciążenia i testy wydajnościowe przed uruchomieniem produkcyjnym.
- Nie weryfikujemy zadania pod kątem zgodności z prawem (np. licencje przekazanych materiałów, RODO, regulamin sklepu).
- Rozdzielne uprawnienia odczytu i zapisu dla wszystkich obiektów API.
- Limit zapytań na minutę, analogicznie do serwera MCP.
- Operacje na cennikach i kontach firmowych w REST API.
Czy REST API pozwala zintegrować sklep z systemem ERP?
Tak. REST API udostępnia towary, zamówienia, klientów, magazyny i inne obiekty sklepu - typowy sposób wymiany danych z ERP, obok gotowych integracji jak Comarch ERP XL czy Navision.
Czy przez REST API można zmieniać ceny w cennikach?
Nie. Cenniki zapisuje się importem z Excela albo przez asystenta AI - REST API nie ma operacji na cennikach.
Czy API obsługuje konta firmowe (B2B)?
Nie. Dane firm zakłada i zmienia wyłącznie obsługa sklepu w panelu.
Czy REST API ma limit zapytań na minutę?
Nie - w przeciwieństwie do serwera MCP, REST API nie ogranicza liczby wywołań. Zbyt intensywne wywołania mogą obciążyć sklep, dlatego zalecamy testy wydajnościowe przed wdrożeniem produkcyjnym.
Ile trwa uruchomienie integracji przez REST API?
Integracja jednego obszaru (np. same zamówienia) - od 8 h. Szerszy zakres, z kilkoma obszarami danych - od 16 h. Dokładny czas zależy od zakresu integracji.
Czy asystent AI (MCP) korzysta z tego samego mechanizmu, co REST API?
Nie wprost. To dwa niezależne sposoby połączenia ze sklepem, oparte o te same uprawnienia kont - REST API do integracji systemowej, MCP do pracy zespołu poleceniami w języku naturalnym.
Chcecie sprawdzić, jak REST API może połączyć Wasz sklep z innym systemem? Umówcie bezpłatną prezentację.
- Włączenie modułu REST API i konfiguracja uprawnień konta - w konfiguracji sklepu.
- Lokacje parametrów API: osobna lokacja dla towarów, kategorii, stron, klientów, widoków i zamówień - parametr trzeba do niej przypisać, żeby był widoczny w odpowiedzi API.
- Adres, pod którym działa API danego sklepu (adres panelu z końcówką API), oraz dane dostępowe konta integracyjnego ustala się przy wdrożeniu.
- Pełna dokumentacja techniczna wywołań, modeli danych i kodów uprawnień - w wiki technicznym Hummerce, dla wdrożeniowca.
- Pełna specyfikacja obiektów i metod (swagger) jest dostępna w wiki technicznym.
- Parametr formatu daty w zapytaniach GET pozwala ustawić format daty zwracanej w odpowiedzi (np. zgodny z ISO 8601), nadrzędnie wobec domyślnego ustawienia sklepu.
- Zapis kategorii towaru i wariantu: pola
categorySymbol (kategoria główna) i categoriesSymbol (lista kategorii); widoczność wariantu na listach zależy od ustawienia sklepu item.lists.subitems.
- Serwer MCP działa niezależnie od REST API - zobacz Asystent AI - serwer MCP.
Parametry udostępniane w API zmienia się w Parametrach i lokacjach, przypisując je do lokacji API odpowiedniego obiektu (towar, kategoria, strona, klient, widok, zamówienie).