Pułapki integracji API, których unikamy
1. Tight coupling: gdy system A pada, system B nie działa. Rozwiązanie: asynchroniczna komunikacja przez kolejkę (message queue) lub retry logic.
2. Brak obsługi błędów: API partnera wraca z błędem 500 i cały process się zatrzymuje. Projektujemy graceful degradation — system działa w trybie awaryjnym.
3. Zmiany API zewnętrznego bez ostrzeżenia: versioning i monitoring endpointów. Alerty gdy API zaczyna zwracać nieoczekiwane odpowiedzi.
Nasz pattern dla integracji: n8n + Supabase
Wzorzec, który stosujemy: zewnętrzne API → n8n (transformacja, obsługa błędów, retry) → Supabase (zapis, logowanie). Aplikacja nigdy nie rozmawia bezpośrednio z zewnętrznym API — zawsze przez warstwę pośrednią.
Zalety: łatwość debugowania (n8n loguje każdy krok), testowanie bez prawdziwego API (mock data), możliwość wymiany integratora bez zmiany aplikacji.
Typowe integracje w polskich projektach B2B
Fakturowanie: iFirma API, wFirma API, Fakturownia. Płatności: Przelewy24, Stripe, PayU. Kurierzy: InPost API, DPD, DHL. Dane firm: GUS API (pobieranie danych po NIP). CRM: Pipedrive API, HubSpot. ERP: Comarch ERP (SOAP — najtrudniejszy), SAP (drogie i trudne).
Reguła praktyczna: REST API jest proste. SOAP (stare systemy) zajmuje 2–3x więcej czasu niż szacujesz. Zawsze pytaj czy API ma dokumentację i czy jest stabilne.
Co możesz zrobić dalej
Masz systemy, które trzeba zintegrować? Oceń bezpłatnie złożoność integracji — wyślij nam listę systemów, z którymi pracujesz.