1. Co to jest API — wyjaśnienie po ludzku
API (Application Programming Interface, czyli interfejs programowania aplikacji) to zestaw reguł i protokołów, który pozwala dwóm programom lub systemom wymieniać dane. Brzmi technicznie, ale w praktyce chodzi o jedną prostą rzecz: umożliwienie systemom rozmowy ze sobą.
Każde narzędzie, z którego korzystasz w firmie, trzyma dane w swojej bazie. HubSpot wie o Twoich klientach. Fakturownia wie o fakturach. BaseLinker wie o zamówieniach. Bez API te bazy są odizolowane — żeby przenieść dane z jednego systemu do drugiego, ktoś musi to zrobić ręcznie, albo eksportować pliki CSV i importować je gdzie indziej.
API rozwiązuje ten problem. Dzięki niemu możesz zapytać HubSpota o listę klientów, poprosić Fakturownię o wystawienie faktury i zaktualizować status zamówienia w BaseLinkerze — wszystko automatycznie, przez jedno oprogramowanie, bez klikania w interfejsy.
API to endpoint (adres URL) wraz z dokumentacją opisującą, jakie zapytania możesz wysłać (metody HTTP: GET, POST, PUT, DELETE), jakie parametry podać i w jakim formacie otrzymasz odpowiedź (zazwyczaj JSON lub XML). Autentykacja odbywa się przez token API lub klucz przekazywany w nagłówku zapytania.
2. Jak API działa w praktyce — analogia kelnera
Najlepszą analogią dla API jest kelner w restauracji. Ty (jako klient aplikacji) siedzisz przy stoliku. Kuchnia (serwer danych) jest za zamkniętymi drzwiami. Kelner (API) to jedyna osoba, która chodzi tam i z powrotem.
Kiedy zamawiasz danie, kelner przynosi Twoje zamówienie do kuchni (wysyła zapytanie do API). Kuchnia przygotowuje danie (przetwarza dane). Kelner przynosi wynik do Twojego stolika (zwraca odpowiedź).
Nie możesz wejść do kuchni samemu — nie masz dostępu do bazy danych bezpośrednio. Ale przez kelnera (API) możesz zamówić wszystko, co jest na menu (dostępne endpointy), zgodnie z zasadami restauracji (ograniczenia uprawnień i limitów).
Przykładowy przepływ: nowe zamówienie w sklepie
POST /orders/add
POST /invoices.json
POST /emails
W praktyce każde zapytanie do API wygląda tak: Twój kod (lub narzędzie automatyzacji jak Make) wysyła żądanie HTTP na konkretny adres URL z odpowiednim tokenem autoryzacji i parametrami. System odbiera żądanie, przetwarza je i zwraca odpowiedź w formacie JSON — np. {"status": "ok", "invoice_id": "FV/2026/05/1234"}.
3. Pięć typów API w biznesie B2B
Nie wszystkie API są jednakowe. W środowisku firmowym spotykasz kilka typów, które różnią się zastosowaniem i poziomem skomplikowania.
REST API — standard dla SaaS
Najczęstszy typ w nowoczesnych narzędziach SaaS. Używa protokołu HTTP, zwraca dane w formacie JSON. Czytelny, lżejszy od SOAP, łatwy do integracji przez Make, Zapier, n8n. Przykłady: HubSpot API, Pipedrive API, Fakturownia API, BaseLinker API.
SOAP API — korporacyjne systemy legacy
Starszy standard oparty na XML. Stosowany w systemach ERP (Comarch Optima, Sage, SAP), bankowych i ubezpieczeniowych. Bardziej rygorystyczny protokół, wymaga parsowania XML. Wymaga dedykowanego kodu — narzędzia no-code obsługują go słabiej.
Webhook — API odwrócone
Zamiast pytać system o zmiany, rejestrujesz adres URL i system sam powiadamia Cię, gdy coś się dzieje. Przykład: HubSpot wysyła powiadomienie do Twojego systemu w momencie, gdy deal zmienia etap. Wydajniejsze niż odpytywanie (polling) co X sekund.
GraphQL — selektywne zapytania
Nowoczesna alternatywa dla REST, gdzie sam definiujesz co chcesz dostać (jakie pola). Używany przez Shopify, GitHub, Contentful. Redukuje ilość przesyłanych danych i liczbę zapytań. Wymaga znajomości składni zapytań GraphQL.
MCP (Model Context Protocol) — API dla agentów AI
Nowy standard Anthropic, który pozwala modelom językowym (jak Claude) wywoływać zewnętrzne narzędzia przez ustandaryzowany protokół. To właśnie ta technologia stoi za BOND — naszym Firmowym Agentem AI. MCP sprawia, że AI może w czasie rzeczywistym odpytywać Twój CRM, ERP i bazy danych.
4. Polskie narzędzia z dobrym API
Wiele polskich narzędzi biznesowych udostępnia API klasy produkcyjnej — ale nie wszystkie firmy o tym wiedzą i korzystają. Oto przegląd narzędzi, które w naszych projektach najczęściej integrujemy przez API:
Pełna obsługa faktur, kontrahentów i płatności. Umożliwia automatyczne fakturowanie po zdarzeniach z CRM lub sklepu.
Agregator zamówień z marketplace'ów. API pozwala zarządzać zamówieniami, statusami i magazynem z jednego miejsca.
Oficjalne API Allegro do zarządzania ofertami, zamówieniami i komunikacją z kupującymi.
Insert Subiekt GT/nexo udostępnia API do dokumentów sprzedaży, towarów i kontrahentów. Integracja z e-commerce i CRM.
Fakturowanie, księgowość, kadry. Dobrze udokumentowane REST API z tokenem autoryzacji.
API płatności — weryfikacja statusu transakcji, obsługa zwrotów, powiadomienia webhookowe.
E-mail marketing i automatyzacje. Zarządzanie listami, kampaniami i tagami kontaktów przez REST API.
CRM klasy enterprise z jednym z najlepszych API na rynku. Kontakty, deale, formularze, workflow — wszystko przez API.
Zanim zlecisz integrację, sprawdź dokumentację API danego narzędzia. Dobre API ma: dokumentację z przykładami (Swagger/OpenAPI), sandboxowe środowisko testowe, limity zapytań (rate limits) jasno opisane i aktywny status page. Wszystkie wymienione narzędzia spełniają te kryteria.
5. Jak API napędza automatyzację procesów
Automatyzacja bez API to zazwyczaj iluzja. Można automatyzować zadania wewnątrz jednego systemu, ale prawdziwa wartość pojawia się, gdy systemy wymieniają dane między sobą w czasie rzeczywistym.
Weźmy prosty przykład: firma B2B, która sprzedaje usługi przez HubSpot i fakturuje przez Fakturownię. Bez API handlowiec zamyka deal w CRM, a potem ręcznie wystawia fakturę. Zajmuje to 5–10 minut. Przy 200 dealach miesięcznie to 30–35 godzin pracy — lub jeden błąd na 10 fakturach, bo ktoś przepisał złe dane.
Z API: zamknięcie deala w HubSpot automatycznie triggeruje webhook, Make odbiera zdarzenie, pobiera dane klienta i wartości z CRM i wysyła żądanie POST do Fakturowni API. Faktura zostaje wystawiona w ciągu 8 sekund. Bez klikania. Bez błędów przepisywania.
Automatyzacja to nie "włącz narzędzie i zapomnij". API wymaga obsługi błędów, logowania zdarzeń i monitorowania. Dobra automatyzacja wie, co zrobić gdy API zwróci błąd 429 (limit zapytań) lub 500 (błąd serwera) — i wysyła powiadomienie do człowieka zamiast po cichu failować.
Co możesz automatyzować przez API polskich narzędzi?
- Automatyczne fakturowanie po zamknięciu deala w CRM (HubSpot + Fakturownia)
- Synchronizacja stanów magazynowych między ERP (Subiekt) a platformami sprzedaży (Allegro, Shopify)
- Dodawanie kontaktu do listy e-mailowej (GetResponse) po wypełnieniu formularza na stronie
- Powiadomienie Slack po zaksięgowaniu płatności (Przelewy24 → Slack)
- Tworzenie zadania w systemie PM po nowym zamówieniu (BaseLinker → ClickUp/Notion)
- Raport sprzedaży dzienny generowany automatycznie z danych CRM i wysyłany e-mailem
- Kwalifikacja leadów przez AI na podstawie danych z CRM i wypełnionego formularza
6. Trzy przykłady przepływów opartych na API
Przepływ 1: Automatyczne fakturowanie B2B
- Handlowiec zamyka deal w HubSpot (etap "Closed Won")
- HubSpot webhook wysyła zdarzenie do Make (lub n8n)
- Make pobiera dane deala: nazwa firmy, NIP, kwota, usługa
- Make sprawdza w Fakturowni czy kontrahent istnieje (GET /clients.json)
- Jeśli nie — tworzy kontrahenta (POST /clients.json)
- Make wystawia fakturę (POST /invoices.json) z pozycjami z deala
- Fakturownia zwraca ID faktury i link do PDF
- Make aktualizuje deal w HubSpot (dodaje link do faktury) i wysyła e-mail do klienta
Czas: 8–12 sekund. Oszczędność: 8–10 minut ręcznej pracy na fakturę.
Przepływ 2: Synchronizacja zamówień e-commerce z ERP
- Nowe zamówienie pojawia się na Allegro lub w sklepie WooCommerce
- BaseLinker API (webhook) powiadamia automatyzację
- Automatyzacja sprawdza dostępność w Subiekcie (GET /documents)
- Tworzy dokument WZ w Subiekcie (POST /documents)
- Aktualizuje status zamówienia w BaseLinkerze i sklepie
- Wysyła e-mail z numerem śledzenia do klienta
Przepływ 3: Kwalifikacja leadów przez AI
- Lead wypełnia formularz na stronie (HubSpot Forms API rejestruje zdarzenie)
- Webhook triggeruje Make — pobiera dane formularza
- Make wysyła dane do Claude API (Anthropic) z promptem kwalifikacji
- AI ocenia lead według zdefiniowanych kryteriów (branża, wielkość firmy, budżet)
- Make aktualizuje deal w HubSpot: dodaje score, tag, właściciela
- Jeśli lead "gorący" — wysyła powiadomienie do handlowca na Slacku z podsumowaniem AI
7. Jak JustAutomate używa API w projektach
Praktycznie każdy projekt JustAutomate zaczyna się od audytu API — sprawdzamy, które systemy klienta mają API, jak dobrze jest udokumentowane, jakie są limity zapytań i czy token autoryzacji jest stabilny (nie wygasa co 30 minut).
W 80% projektów używamy Make (dawniej Integromat) jako middleware — narzędzia, które łączy API różnych systemów bez pisania kodu. Make obsługuje autentykację, retry po błędach, mapowanie danych i logowanie. Dla bardziej złożonych przypadków piszemy własne skrypty w Node.js lub Python, które dają pełną kontrolę nad logiką.
Nasz Firmowy Agent AI — BOND — idzie krok dalej. Zamiast tylko przesyłać dane między systemami, BOND rozumie kontekst. Możesz zapytać: "Które faktury od firm z sektora produkcyjnego są przeterminowane powyżej 30 dni?" i BOND sam wywoła odpowiednie API, połączy dane z różnych systemów i zwróci konkretną odpowiedź — bez tworzenia raportu ręcznie.
Pierwsza konsultacja (30 minut) jest bezpłatna. Podczas rozmowy omawiamy jakie systemy używasz, które API są dostępne i jakie przepływy chcesz zautomatyzować. Na podstawie tego przygotowujemy konkretny plan z szacunkowym ROI — bez zobowiązań.
Najczęstsze pytania o API
Co to jest API w prostych słowach?
API (Application Programming Interface) to zestaw reguł, który pozwala dwóm programom rozmawiać ze sobą. Wyobraź sobie kelnera między kuchnią a gościem restauracji — API pośredniczy między Twoim systemem a innym narzędziem i przekazuje dane w obie strony.
Czy potrzebuję programisty, żeby korzystać z API?
Nie zawsze. Narzędzia takie jak Make, Zapier czy n8n pozwalają budować integracje API bez pisania kodu — przez interfejs graficzny. Jeśli jednak potrzebujesz niestandardowej logiki lub integracji z systemem legacy (ERP, bankowość), partner techniczny jest potrzebny.
Jakie polskie narzędzia mają dobre API?
Fakturownia, BaseLinker, Subiekt GT/nexo, iFirma, Przelewy24, Allegro (REST API v6+), GetResponse. Wszystkie udostępniają dokumentację techniczną i obsługują standardowe REST API z tokenem autoryzacji.
Czym różni się REST API od SOAP API?
REST API używa protokołu HTTP i zwraca dane w formacie JSON — lżejszym i prostszym w obsłudze. SOAP to starszy standard oparty na XML, stosowany głównie w systemach korporacyjnych i ERP. Większość nowoczesnych narzędzi SaaS udostępnia REST API.
Ile kosztuje integracja przez API?
Koszt integracji zależy od liczby systemów, złożoności logiki biznesowej i zakresu transformacji danych — od prostego połączenia dwóch narzędzi po integracje z obsługą błędów i niestandardową logiką. Wycena indywidualna po rozmowie o konkretnym przypadku.
Jak API pomaga w automatyzacji firmy?
API pozwala systemom wymieniać dane automatycznie, bez ręcznego kopiowania. Przykład: nowe zamówienie w sklepie automatycznie tworzy fakturę, aktualizuje CRM i wysyła potwierdzenie do klienta — bez udziału człowieka, w ciągu kilku sekund.
Chcesz zintegrować swoje systemy przez API?
Powiedz nam jakie narzędzia używasz. Pokażemy co można połączyć i jakie przepływy da się zautomatyzować — konkretnie, z szacunkowym ROI.