BaseLinker API – co można zautomatyzować i jak zacząć integrację

BaseLinker API przydaje się wtedy, gdy gotowe integracje i akcje automatyczne przestają wystarczać. Chcesz przesłać zamówienia do własnego ERP, zasilić hurtownię danych raportami albo zbudować narzędzie, którego nie ma w panelu? Base (dawniej BaseLinker) udostępnia interfejs, przez który zewnętrzny system może pobierać i zmieniać dane na Twoim koncie.

W tym artykule wyjaśniamy, jak działa API Base, jakie obszary obejmuje, jakie ma limity i od czego zacząć pierwszy projekt integracyjny. Opisujemy też typowe zastosowania, z którymi spotykamy się przy wdrożeniach, i błędy, które najczęściej kończą się utratą danych lub zablokowaniem zapytań.

Jak działa BaseLinker API – podstawy techniczne

API Base to interfejs oparty na zapytaniach POST wysyłanych do jednego adresu, pliku connector.php w domenie api.baselinker.com. Każde zapytanie zawiera nazwę metody i parametry w formacie JSON, a odpowiedź również przychodzi jako JSON. Dokumentacja jest publiczna i dostępna pod adresem api.baselinker.com, razem z narzędziem do testowania zapytań.

Do autoryzacji służy token przypisany do konta użytkownika. Wygenerujesz go w panelu w sekcji Moje konto, w zakładce API. Dokumentacja zaleca przesyłanie tokenu w nagłówku HTTP X-BLToken – przekazywanie go jako parametru zapytania jest oznaczone jako przestarzałe.

Element	Jak to wygląda	Uwagi
Adres	api.baselinker.com/connector.php	Wszystkie metody pod jednym adresem
Metoda HTTP	POST	Parametry: method i parameters
Autoryzacja	Token w nagłówku X-BLToken	Token generujesz w Moje konto → API
Format danych	JSON, kodowanie UTF-8	Treści base64 wymagają zamiany znaku + na %2B
Limit	100 zapytań na minutę	Wyższe limity w ramach płatnych akceleracji

Dostęp do API jest wymieniony w cenniku Base już w planie Freemium, a w planie Enterprise dochodzi wsparcie API. Szczegóły planów opisujemy w tekście BaseLinker cennik 2026.

Co można zautomatyzować przez API Base

Lista metod jest długa i regularnie się rozwija – dokumentacja pokazuje datę ostatniej aktualizacji. Metody są pogrupowane w kilka obszarów, które w praktyce pokrywają większość pracy w panelu:

Zamówienia – pobieranie, dodawanie, edycja pól, zmiana statusów, płatności, faktury, paragony i listy zbierania.
Zwroty – pobieranie zwrotów, ich produktów, statusów i płatności.
Przesyłki kurierskie – tworzenie paczek, pobieranie etykiet, zamawianie odbiorów i sprawdzanie statusów.
Katalog produktów – produkty, kategorie, producenci, grupy cenowe, magazyny, lokalizacje, dokumenty magazynowe, zamówienia zakupu i dostawcy.
Magazyny zewnętrzne – odczyt danych ze sklepów i hurtowni podłączonych do Base.
Base Connect – dane o współpracy B2B z kontrahentami.

W praktyce oznacza to, że przez API zrobisz niemal wszystko, co wymaga przeniesienia danych między Base a innym systemem. Część scenariuszy da się jednak zrealizować prościej, bez pisania kodu – przez akcje automatyczne w panelu albo narzędzia typu Zapier i Make. Porównanie tych dróg znajdziesz w artykule BaseLinker Zapier i Make.

Wykres – sześć obszarów API Base i przykładowe zadania, które można w nich zautomatyzować. [#chart:b63]

BaseLinker API przydaje się wtedy, gdy gotowe integracje i akcje automatyczne przestają wystarczać. Chcesz przesłać zamówienia do własnego ERP, zasilić hurtownię danych raportami albo zbudować narzędzie, którego nie ma w panelu? Base (dawniej BaseLinker) udostępnia interfejs, przez który zewnętrzny system może pobierać i zmieniać dane na Twoim koncie.

W tym artykule wyjaśniamy, jak działa API Base, jakie obszary obejmuje, jakie ma limity i od czego zacząć pierwszy projekt integracyjny. Opisujemy też typowe zastosowania, z którymi spotykamy się przy wdrożeniach, i błędy, które najczęściej kończą się utratą danych lub zablokowaniem zapytań.

Jak działa BaseLinker API – podstawy techniczne

API Base to interfejs oparty na zapytaniach POST wysyłanych do jednego adresu, pliku connector.php w domenie api.baselinker.com. Każde zapytanie zawiera nazwę metody i parametry w formacie JSON, a odpowiedź również przychodzi jako JSON. Dokumentacja jest publiczna i dostępna pod adresem api.baselinker.com, razem z narzędziem do testowania zapytań.

Do autoryzacji służy token przypisany do konta użytkownika. Wygenerujesz go w panelu w sekcji Moje konto, w zakładce API. Dokumentacja zaleca przesyłanie tokenu w nagłówku HTTP X-BLToken – przekazywanie go jako parametru zapytania jest oznaczone jako przestarzałe.

Element	Jak to wygląda	Uwagi
Adres	api.baselinker.com/connector.php	Wszystkie metody pod jednym adresem
Metoda HTTP	POST	Parametry: method i parameters
Autoryzacja	Token w nagłówku X-BLToken	Token generujesz w Moje konto → API
Format danych	JSON, kodowanie UTF-8	Treści base64 wymagają zamiany znaku + na %2B
Limit	100 zapytań na minutę	Wyższe limity w ramach płatnych akceleracji

Dostęp do API jest wymieniony w cenniku Base już w planie Freemium, a w planie Enterprise dochodzi wsparcie API. Szczegóły planów opisujemy w tekście BaseLinker cennik 2026.

Co można zautomatyzować przez API Base

Lista metod jest długa i regularnie się rozwija – dokumentacja pokazuje datę ostatniej aktualizacji. Metody są pogrupowane w kilka obszarów, które w praktyce pokrywają większość pracy w panelu:

Zamówienia – pobieranie, dodawanie, edycja pól, zmiana statusów, płatności, faktury, paragony i listy zbierania.
Zwroty – pobieranie zwrotów, ich produktów, statusów i płatności.
Przesyłki kurierskie – tworzenie paczek, pobieranie etykiet, zamawianie odbiorów i sprawdzanie statusów.
Katalog produktów – produkty, kategorie, producenci, grupy cenowe, magazyny, lokalizacje, dokumenty magazynowe, zamówienia zakupu i dostawcy.
Magazyny zewnętrzne – odczyt danych ze sklepów i hurtowni podłączonych do Base.
Base Connect – dane o współpracy B2B z kontrahentami.

W praktyce oznacza to, że przez API zrobisz niemal wszystko, co wymaga przeniesienia danych między Base a innym systemem. Część scenariuszy da się jednak zrealizować prościej, bez pisania kodu – przez akcje automatyczne w panelu albo narzędzia typu Zapier i Make. Porównanie tych dróg znajdziesz w artykule BaseLinker Zapier i Make.

Wykres – sześć obszarów API Base i przykładowe zadania, które można w nich zautomatyzować. [#chart:b63]

Skorzystaj z darmowego audytu konta Allegro

Szybkie i proste poprawki

Analiza ofert i sklepu

Kluczowe wskazówki na przyszłość

Skorzystaj z darmowego audytu konta Allegro

Szybkie i proste poprawki

Analiza ofert i sklepu

Kluczowe wskazówki na przyszłość

Najczęstsze zastosowania BaseLinker API w firmach

Z naszej praktyki wynika, że po API sięgają głównie firmy, które mają już własne systemy i chcą, żeby Base był jednym z elementów większej układanki. Najczęstsze scenariusze wyglądają tak:

Scenariusz	Kluczowe metody	Efekt
Integracja z własnym ERP	getOrders, getJournalList, updateInventoryProductsStock	Zamówienia w ERP, stany wracają do Base
Raporty i BI	getOrders, getOrderSources, getInvoices	Dane sprzedażowe w hurtowni danych lub arkuszu
Automatyczne ceny	updateInventoryProductsPrices	Ceny z systemu kalkulacyjnego trafiają do katalogu
Własny magazyn lub WMS	createPackage, getLabel, setOrderStatus	Etykiety i statusy generowane z zewnętrznego systemu
Sklep na własnym silniku	addOrder, addInventoryProduct	Zamówienia i produkty trafiają do Base bez wtyczki

Integracja z ERP to osobny, duży temat – zanim zaczniesz pisać kod, warto zaplanować, który system jest źródłem prawdy dla stanów, cen i dokumentów. Podpowiadamy, jak to zrobić, w tekście o integracji Base z ERP.

Niezależnie od scenariusza dobrze jest od początku spisać dokumentację integracji: jakie metody są wywoływane, z jaką częstotliwością, który token jest używany i kto odpowiada za utrzymanie. Taki dokument oszczędza dziesiątki godzin, gdy po roku trzeba coś zmienić albo gdy integrację przejmuje nowy wykonawca. Przydaje się też przy zmianie planu w Base, bo od razu widać, które procesy zależą od limitów API.

API, akcje automatyczne czy Zapier – kiedy co wybrać

API daje największą swobodę, ale też najwięcej kosztuje w utrzymaniu. Zanim zlecisz programowanie, porównaj trzy drogi automatyzacji dostępne w Base. Często okazuje się, że połowę wymagań da się spełnić w panelu, a kod jest potrzebny tylko do jednego, specyficznego elementu.

Droga	Kiedy się sprawdza	Ograniczenia
Akcje automatyczne	Procesy w obrębie Base: statusy, faktury, etykiety, wiadomości	Nie wyślą danych do dowolnego zewnętrznego systemu
Zapier lub Make	Proste przepływy do popularnych aplikacji, np. arkuszy, CRM, newslettera	Opłaty za zadania i mniejsza kontrola nad logiką przy dużych wolumenach
Własna integracja API	ERP, hurtownia danych, nietypowe procesy, duże wolumeny	Wymaga programisty, testów i stałego utrzymania

Dobrą praktyką jest zaczynanie od najprostszego rozwiązania i przechodzenie na API dopiero wtedy, gdy narzędzia bez kodu przestają wystarczać. Dzięki temu nie płacisz za rozbudowaną integrację, z której wykorzystujesz kilka procent możliwości.

Jak zacząć integrację przez API krok po kroku

Nawet prosty projekt API warto przeprowadzić według planu. Poniższa kolejność sprawdza się zarówno przy małych skryptach, jak i przy dużych integracjach.

1. Opisz proces, zanim wybierzesz metody

Zapisz, jakie dane mają płynąć, w którą stronę i jak często. „Zamówienia opłacone trafiają do ERP co 5 minut, stany wracają do Base co 15 minut” to dobra specyfikacja. „Połączmy Base z ERP” – już nie.

2. Wygeneruj osobny token dla integracji

Przy generowaniu tokenu podajesz nazwę aplikacji, więc łatwo później rozpoznać, który system korzysta z którego dostępu. Traktuj token jak hasło: nie wklejaj go do publicznych repozytoriów i nie przesyłaj otwartym tekstem. Więcej o zasadach dostępu piszemy w artykule o bezpieczeństwie konta Base.

3. Przetestuj zapytania w dokumentacji

Dokumentacja ma wbudowane narzędzie do testowania zapytań. Zanim napiszesz pierwszą linijkę kodu, sprawdź, jak wyglądają odpowiedzi dla Twoich danych – na przykład jakie identyfikatory mają statusy i źródła zamówień.

4. Zaprojektuj pobieranie zamówień bez dziur

Metoda getOrders zwraca maksymalnie 100 zamówień w jednej odpowiedzi, a dokumentacja zaleca pobieranie tylko potwierdzonych zamówień, bo niepotwierdzone mogą być niekompletne. Do śledzenia nowych zdarzeń służy getJournalList, która zwraca zdarzenia z ostatnich 3 dni – jeśli zwraca pustą odpowiedź, trzeba ją włączyć w ustawieniach API konta.

5. Pilnuj limitów i loguj błędy

Standardowy limit to 100 zapytań na minutę. Grupuj operacje – na przykład updateInventoryProductsStock przyjmuje do 1000 produktów w jednym wywołaniu – i zapisuj odpowiedzi ze statusem błędu, żeby szybko wiedzieć, co poszło nie tak.

6. Uruchom na kopii danych i dopiero potem na produkcji

Najpierw testuj na ograniczonym zakresie produktów lub zamówień. Błędnie napisany import potrafi nadpisać opisy czy ceny w całym katalogu, więc przed pierwszym uruchomieniem zrób eksport katalogu jako kopię zapasową.

Błędy, których warto unikać przy pracy z API

Większość problemów z integracjami API ma wspólne źródło: brak planu na sytuacje wyjątkowe. Zwróć uwagę zwłaszcza na te pułapki:

Pobieranie wszystkich zamówień co minutę – szybko wyczerpuje limit i niczego nie przyspiesza; lepiej korzystać z dziennika zdarzeń.
Brak obsługi stronicowania – przy 100 zamówieniach w odpowiedzi trzeba pobrać kolejną paczkę, inaczej część zamówień nie dotrze do systemu.
Dwa systemy zmieniające te same stany – jeśli ERP i Base jednocześnie aktualizują stan, powstaje wyścig i rozbieżności.
Jeden token dla wszystkich – po odejściu wykonawcy nie wiadomo, który dostęp wyłączyć.
Brak monitoringu – integracja „cicho” przestaje działać i dowiadujesz się o tym od klientów.

Jeśli Twoim celem jest automatyzacja procesów w samym panelu, często szybciej zadziałają wbudowane mechanizmy. Zobacz gotowe scenariusze w tekście akcje automatyczne w BaseLinkerze. Przy sprzedaży na Allegro warto też wiedzieć, co oferuje bezpośrednio Allegro REST API.

Najczęściej zadawane pytania

Czy BaseLinker API jest płatne?

Dostęp do API jest wymieniony w cenniku Base już w darmowym planie Freemium. Dodatkowo płatne mogą być akceleracje, które podnoszą limit zapytań ponad standardowe 100 na minutę. Aktualne warunki sprawdź w cenniku Base i w panelu w dziale akceleracji.

Gdzie znaleźć token API w Base?

Token wygenerujesz w panelu: kliknij swoje imię i nazwisko, przejdź do sekcji Moje konto i otwórz zakładkę API. Podaj nazwę aplikacji i wygeneruj token. Dla każdej integracji warto utworzyć osobny.

Jaki jest limit zapytań w API Base?

Dokumentacja podaje limit 100 zapytań na minutę. W dziale akceleracji można go podnieść za dodatkową opłatą, co przydaje się przy dużych katalogach i intensywnych synchronizacjach.

Czy przez API mogę pobierać zamówienia z Allegro?

Tak, ale pośrednio. API Base zwraca zamówienia, które trafiły do Managera zamówień z dowolnego źródła, w tym z Allegro. Źródło zamówienia rozpoznasz po polach opisujących jego pochodzenie.

Czy do integracji przez API potrzebuję programisty?

Do własnej integracji tak, bo trzeba napisać i utrzymywać kod. Jeśli nie masz zespołu technicznego, sprawdź najpierw gotowe integracje, akcje automatyczne oraz narzędzia Zapier i Make, które korzystają z API Base bez pisania kodu.

Czy mogę przez API aktualizować stany wielu produktów naraz?

Tak. Metoda updateInventoryProductsStock pozwala zaktualizować stany do 1000 produktów lub wariantów w jednym wywołaniu. Przy większych katalogach dzielisz aktualizację na paczki i pilnujesz limitu zapytań na minutę.

Jak często zmienia się API Base?

Dokumentacja ma dziennik zmian i datę ostatniej aktualizacji. Przy utrzymywaniu integracji warto regularnie go przeglądać, bo dochodzą nowe metody, a niektóre parametry są oznaczane jako przestarzałe.

Podsumowanie

API Base otwiera drogę do automatyzacji, których nie zrobisz w panelu: integracji z ERP, raportowania, zewnętrznego magazynu czy własnego sklepu. Klucz do sukcesu to dobry plan przepływu danych, rozsądne korzystanie z limitów i monitoring, który wychwyci problem, zanim zauważą go klienci.

Jeśli planujesz integrację przez API i chcesz ją dobrze zaprojektować od strony procesów, porozmawiaj z nami. Jako certyfikowany partner wdrożeń Base pomagamy połączyć panel z resztą firmy – zobacz, jak wygląda wdrożenie Base.