REST · GraphQL · SOAP · ESB · iPaaS

Integracje API — łączenie systemów które się nie lubią

REST, GraphQL, SOAP/WSDL, webhooks, file-based, DB-to-DB. Łączenie polskich ERP (Comarch, Subiekt, Sage), SaaS (Salesforce, HubSpot, Stripe), government APIs (KSeF, BIK, GUS, KRS), legacy systems (mainframe, AS/400, EDI, COBOL). OAuth2, mTLS, OWASP API Top 10. Modernizacja monolitów do microservices.

Wyceń integrację w 24 h Architektury

01 / Typy integracji

Sześć protokołów. Wybór zależy od systemu

Modern systemy mówią REST/GraphQL. Legacy enterprise — SOAP/WSDL. Mainframe — EDI/AS2/MQ. File-based dla starych ERP. Robimy każdy i tłumaczymy między nimi.

REST APIs

Najpopularniejszy standard nowych integracji. JSON over HTTP, status codes, idempotent verbs. OpenAPI 3.1 spec, Swagger UI, Postman collections, mock servers dla developerów.

JSON · OpenAPI 3.1 · modern

GraphQL

Single endpoint, klient pyta o dokładnie te pola które potrzebuje. Szczególnie dobry dla mobile (oszczędność transferu) i frontend z różnymi widokami. Apollo, Hasura, GraphQL Yoga.

single endpoint · flexible

SOAP / WSDL

Klasyk enterprise — banki, ubezpieczenia, mainframe, BIK, ZUS. XML over HTTP/HTTPS, WSDL contracts, WS-Security z certyfikatami. Często wymagane przez regulowane systemy.

XML · WS-Security · legacy

Webhooks + event-driven

Zamiast polling — system A wywołuje POST na URL systemu B gdy coś się dzieje. Plus event brokers: Kafka, RabbitMQ, IBM MQ, AWS SQS. Asynchroniczne, skalowalne, fault-tolerant.

Kafka · RabbitMQ · async

File-based (CSV, XML, EDI)

FTP/SFTP, AS2, EDIFACT, X12 dla legacy ERP i partnerów handlowych. CSV/XML batch processing, scheduled imports, error handling z retry. Częste w retail, logistyce, B2B EDI.

SFTP · AS2 · EDIFACT

Database-to-database

ETL (Talend, Pentaho), CDC (Debezium, Oracle GoldenGate), replikacja master-slave. Gdy API nie ma lub jest za wolne — bezpośrednia synchronizacja baz. Także dla data warehouse.

ETL · CDC · replication

02 / Architektury integracji

Cztery wzorce. Dobierane do skali

Dla 5 systemów wystarczy point-to-point. Dla 50 systemów — potrzebujesz API Gateway lub ESB. Dla 500 — iPaaS lub event-driven mesh. Pomagamy wybrać i implementujemy.

Point-to-Point

System A bezpośrednio woła system B. Najprostsze, ale przy 5+ systemach robi się O(n²) integracji. OK dla małej skali (do 5 systemów), MVP, prototypów.

do 5 systemów · tańsze

API Gateway

Single entry point: auth, rate limiting, logging, transformation. Kong, AWS API Gateway, Azure API Management, Tyk. Idealne dla microservices i public APIs.

5–50 systemów · Kong/AWS

ESB / Message Broker

Enterprise Service Bus (Mule, Oracle SOA Suite, IBM Integration Bus) lub message broker (Kafka, RabbitMQ, IBM MQ). Async, fault-tolerant, dla legacy enterprise.

50+ systemów · WebLogic SOA

iPaaS (cloud-based)

Mule Anypoint, Boomi, Workato, Azure Logic Apps, n8n. Gotowe konektory do popularnych SaaS, no-code/low-code workflow builder. Dobry dla średniej skali.

SaaS-heavy · szybkie wdrożenie

03 / Proces wdrożenia

Pięć etapów. Z testami contract

Etap 4 (Testing) — contract testing, postman collections, mocked services, load testing. Większość failów integracyjnych wynika z pominięcia testów contract. Robimy to standardowo.

Discovery

Workshop: które systemy, jakie operacje, volume, latency requirements, compliance, secrets management.

3–7 dni

API Design

OpenAPI 3.1 spec, error model, authentication, versioning, rate limits. Review z klientem przed implementacją.

5–10 dni

Implementation

Kod produkcyjny + testy unit/integration. Mocked external services dla dev. CI/CD pipeline od dnia 1.

2–12 tyg

Testing

Contract tests (Pact), load tests (k6, Gatling), security scan (OWASP ZAP), penetration test, error injection.

1–3 tyg

Production

Deploy z blue-green, monitoring (Prometheus, Grafana), alerting, runbooki, dokumentacja, training zespołu klienta.

3 dni + ongoing

04 / Modele wyceny

Trzy formaty rozliczenia. Wybierasz pod ryzyko

T&M dla integracji eksploracyjnych. Fixed Price gdy spec OpenAPI gotowy. Dedicated team dla portfela 10+ integracji równoległych (banki, telco).

Time & Material

Stawka dzienna, raporty miesięczne, scope elastyczny.

stawki dzienne · raport mies.

Senior dev: 1 200–1 800 zł/dzień
API architect: 1 800–2 400 zł/dzień
Raporty godzinowe miesięcznie
Scope zmienialny w trakcie
Idealny dla R&D, eksploracji
Limit budżetowy do uzgodnienia
Faktura VAT z załącznikiem

Wybieram T&M

Fixed Price

Stała cena per integracja, scope w OpenAPI.

scope OpenAPI + cena + deadline

Cena ustalona w SOW przed startem
OpenAPI 3.1 spec jako contract
Discovery na zakończenie (10%)
Płatność 30/40/30
Ryzyko po naszej stronie
Change request — aneks SOW
Kary umowne za opóźnienia

Wybieram Fixed

Dedicated team

2–4 inżynierów na portfel integracji 12+ mies.

12+ mies · named team

2–4 osoby (dev, architect, QA)
Stała stawka miesięczna za team
Pełne dedykowane resources
Daily standup + sprint planning
Backlog 10+ integracji równoległych
Idealny dla bank, telco, e-commerce
SLA na ramp-up nowych integracji

Wybieram Team

05 / FAQ

Najczęstsze pytania

Brak odpowiedzi? Napisz do nas — odpisuje API architect, nie sales.

Custom integracja czy iPaaS (Mule, Boomi, Workato)?

iPaaS dla 60% przypadków: szybciej (tygodnie zamiast miesięcy), tańsze utrzymanie (drag-and-drop workflow), gotowe konektory dla popularnych SaaS (Salesforce, HubSpot, Stripe, Slack). Cena: 5k–30k zł/mies. Custom (Java/Node/Python) gdy: (1) mass volume (>1M zdarzeń/dzień, gdzie iPaaS robi się drogi za eventy), (2) unikalna logika biznesowa której iPaaS nie obsługuje, (3) integracje z legacy (mainframe, AS/400, COBOL — brak konektora w iPaaS), (4) wymóg on-prem (KNF, ISO 27001 — zakaz cloud iPaaS), (5) low-latency requirements (<10ms, gdzie iPaaS dodaje narzut), (6) full control nad release cycle. Robimy oba — pomożemy wybrać po audycie scope.

Czy obsługujecie KSeF, BIK, GUS i inne polskie API?

Tak, doświadczenie 10+ lat. KSeF (Krajowy System e-Faktur) — wystawianie i odbiór faktur XML w schemacie FA(3), tryb online/offline, obsługa korekt i zaliczek. Obowiązkowy od 2026. BIK (Biuro Informacji Kredytowej) — sprawdzanie historii kredytowej, BIK Kompletny, BIK Score, mTLS z certyfikatem. KRS / CEIDG — lookup danych firmowych po NIP/REGON (wyszukiwarka KRS). GUS / REGON — weryfikacja numerów REGON, dane statystyczne. e-Doręczenia (Poczta Polska) — dostarczanie pism urzędowych. ePUAP — komunikacja z urzędami administracji. JPK_VAT — eksport plików kontrolnych. BDO (rejestr odpadów) — raportowanie, wymóg prawny. Wszystkie z dokumentacją API i certyfikatami producenta.

Ile trwa wdrożenie integracji?

Zależy od kompleksowości. Prosta integracja REST ↔ REST (np. WordPress → Mailchimp): 1–2 tygodnie. Średnia z mappingiem danych (np. e-commerce → Comarch ERP): 4–8 tygodni. Złożona z legacy (np. CRM → mainframe COBOL przez MQ): 3–6 miesięcy. Portfel 5–10 integracji (np. dla banku, telco): 6–12 miesięcy z dedicated team. Każda integracja ma kamienie milowe co 2 tygodnie z demo. Pierwsza działająca wersja (mock + happy path) — po 5–10 dniach. Production-ready (z error handling, retries, monitoring, security) — per kompleksowość.

Co z modernizacją starych systemów (mainframe, AS/400)?

Robimy to od 15 lat — jest sporo COBOL-a w polskich bankach i ubezpieczeniach. Strategia: nie przepisujemy mainframe od zera (5+ lat ryzyka, miliony USD). Wystawiamy modern API przed mainframem — REST/GraphQL gateway który tłumaczy do MQ/CICS/IMS. Wzorce: (1) Strangler Fig — nowe features w nowoczesnym stacku, stare zostają. (2) Database View — nowy aplikacja czyta z mainframe DB2 read-only przez API. (3) Event-driven — mainframe publikuje eventy do Kafki, modern systemy konsumują. (4) Gradual migration — tabela po tabeli, feature po feature, monitoring konsystencji. Doświadczenie z PZU, Aviva, banki SK.

Ile kosztuje utrzymanie po wdrożeniu?

Zależy od skali. Pojedyncza integracja (REST, do 5 endpointów): 490–990 zł/mies — security patches, monitoring, drobne zmiany. Portfel 5–10 integracji: 1 990–3 990 zł/mies — jw + nowe konektory + onboarding nowych systemów. Enterprise (50+ integracji, ESB, mainframe): 9 990 zł–29 990 zł/mies — named team, SLA 99.95%, kary umowne. Utrzymanie obejmuje: monitoring (uptime, latency, errors), patching (CVE, dependencies), nowe wersje API zewnętrznych (np. Salesforce v60 → v61), backup-recovery, on-call rotation. Dedicated team dostępny dla portfela 10+ integracji.

Jak rozpocząć?

Najczęstsza ścieżka: (1) piszesz na [email protected] z opisem (które systemy łączysz, kierunek przepływu danych, volume zdarzeń, real-time czy batch, compliance, deadline); (2) w 24 h odpowiada API architect z 5–7 pytaniami; (3) 30-min telekonferencja z architektem; (4) Discovery workshop 1–2 tyg z wyborem architektury (P2P / API Gateway / ESB / iPaaS); (5) oferta z OpenAPI spec i konkretną ceną w 48–72 h; (6) NDA + MSA + SOW i start. Pre-Discovery audit (free, 2 dni) dla wyboru architektury — doradzimy custom czy iPaaS, REST czy SOAP, on-prem czy cloud.

06 / Diagnostyka

Sprawdź swoje API przed integracją

Cztery komendy curl — zmierz dostępność, nagłówki, autoryzację i latencję. Wynik powie nam (i Tobie), z czym zaczynamy.