/integracje api
Integracje API dla firm
Firma nazywa się ApiFamily nie bez powodu — łączenie systemów, które nie zostały zaprojektowane do współpracy, to nasz główny obszar pracy. Budujemy warstwę integracyjną, w której dane krążą same, a człowiek nie przepisuje ich z okna do okna.
Łączenie systemów
Typowa firma po kilku latach ma sklep, program magazynowy, system księgowy, arkusz z cennikiem i skrzynkę, przez którą to wszystko się schodzi. Każdy z tych elementów działa poprawnie osobno. Problem pojawia się na styku — tam, gdzie ktoś musi codziennie kopiować dane.
Integracja API usuwa ten styk. Zamiast człowieka pośredniczącego między dwoma programami pojawia się warstwa, która wie, skąd wziąć dane, w jaki format je przetłumaczyć i co zrobić, gdy druga strona nie odpowiada.
Trzy sposoby, w jakie to robimy
- Integracja punkt–punkt — dwa systemy, jeden konkretny przepływ danych. Najszybsze i najtańsze rozwiązanie, dobre przy 2–3 systemach.
- Warstwa integracyjna (middleware) — jeden centralny element, do którego podłączamy kolejne systemy. Ma sens od czterech systemów w górę, bo dodanie piątego nie wymaga przepisywania poprzednich.
- Własne API firmy — Twoje dane udostępnione w jednym, udokumentowanym standardzie, z którego korzystają sklep, aplikacja mobilna i partnerzy handlowi.
Od czego zaczynamy
Od mapy danych: co jest źródłem prawdy dla stanu magazynowego, co dla ceny, co dla statusu zamówienia. Dopóki to nie jest ustalone, każda integracja będzie generować konflikty. Ta rozmowa zajmuje zwykle godzinę i oszczędza tygodnie poprawek.
Co najczęściej integrujemy
Systemy, z którymi mamy realny przebieg — wdrożenie idzie szybciej, bo znamy ich ograniczenia i miejsca, w których się psują.
Modele AI
- OpenAI GPT
- ChatGPT
- Google Gemini
- Anthropic Claude
Odczyt danych z dokumentów, klasyfikacja zgłoszeń, treści na wiele rynków, wyszukiwanie semantyczne. Z warstwą pośrednią, żeby zmiana dostawcy była zmianą konfiguracji.
Przewoźnicy i logistyka
- InPost
- Paxy
- Olza Logistic
- DHL
- Poczta Polska
- ID Logistics
- ROHLIG SUUS Logistics
Etykiety i listy przewozowe, punkty odbioru, śledzenie przesyłek, zwroty, przesyłki pobraniowe, manifesty dla kuriera.
Płatności
- Blik
- PayU
- Tpay
- PayPal
- Swish
- MobilePay
- iDEAL
- Bancontact
- Apple Pay
- Google Pay
- Montonio
Płatność online, powiadomienia o zaksięgowaniu, zwroty pełne i częściowe, metody dobierane do rynku i waluty.
Systemy ERP i księgowe
- Subiekt GT
- Enova 365
- Comarch ERP
- Symfonia
Kartoteki towarowe i cenniki, stany magazynowe, kontrahenci, zamówienia, dokumenty sprzedaży, rozrachunki.
Rejestratorzy domen
- NASK
- EuroDNS
Sprawdzanie dostępności, rejestracja, odnawianie, transfer między rejestratorami, zarządzanie rekordami DNS.
Sklepy i sprzedaż
Sprzedaż wielokanałowa i wielorynkowa: jeden stan magazynowy dla wszystkich kanałów, synchronizacja cen i asortymentu, pobieranie zamówień, aktualizacja statusów. Pracowaliśmy między innymi ze sklepem obsługującym 24 domeny na rynkach europejskich.
Twojego systemu tu nie ma?
Jeśli ma API, usługę sieciową albo choćby eksport danych do pliku — prawie zawsze da się go podłączyć. Integrowaliśmy też systemy, które oficjalnie żadnego interfejsu nie mają.
API dla aplikacji mobilnych
Aplikacja mobilna jest tylko interfejsem — cała logika i dane muszą stać po stronie serwera. Budujemy backend i API, z którego korzysta aplikacja na iOS i Androida: uwierzytelnianie użytkowników, powiadomienia push, praca offline z synchronizacją, wersjonowanie odpowiedzi.
Wersjonowanie jest tu kluczowe: użytkownicy nie aktualizują aplikacji w tym samym momencie, więc API musi obsługiwać jednocześnie starą i nową wersję klienta. Planujemy to od początku, a nie przy pierwszym wymuszonym update'zie.
Tworzenie własnego API
Jeśli Twoje dane mają być dostępne dla partnerów, aplikacji mobilnej albo kilku wewnętrznych systemów, potrzebne jest jedno API zamiast pięciu eksportów do CSV.
Co dostajesz
- REST API lub GraphQL — dobrane do sposobu, w jaki dane będą odpytywane.
- Dokumentacja OpenAPI — interaktywna, do samodzielnego przetestowania przez odbiorcę.
- Uwierzytelnianie i uprawnienia — OAuth 2.0, JWT lub klucze API, z kontrolą zakresu dostępu.
- Limity zapytań — ochrona przed przeciążeniem przez jednego klienta.
- Wersjonowanie — zmiany bez psucia integracji, które już działają.
- Webhooki — powiadamianie odbiorców o zdarzeniach, zamiast odpytywania co minutę.
- Środowisko testowe — sandbox, na którym partner podłącza się bez ryzyka.
Dlaczego integracje przestają działać
Cztery przyczyny, które widzimy w co drugim przejmowanym projekcie — i to, jak się przed nimi zabezpieczamy.
Cudze API przestało odpowiadać
Skrypt uruchamiany co godzinę trafia na awarię, kończy się błędem i nikt tego nie zauważa. Zamówienia z tej godziny nie istnieją.
Jak to robimy: każde zadanie ląduje w kolejce z ponawianiem i rosnącym odstępem. Po serii nieudanych prób leci alert do konkretnej osoby, a dane czekają — nie znikają.
Dwie strony zmieniły ten sam rekord
Stan magazynowy zmienił się jednocześnie w ERP i w sklepie. Który jest prawdziwy? Bez ustalonej reguły — losowy.
Jak to robimy: dla każdego pola ustalamy źródło prawdy i kierunek synchronizacji. Konflikty są logowane, a nie nadpisywane po cichu.
To samo zamówienie przyszło dwa razy
Powiadomienie webhook zostało wysłane ponownie, bo pierwsza odpowiedź się nie doszła. Efekt: podwójna wysyłka i podwójna faktura.
Jak to robimy: każda operacja ma klucz idempotencji. Powtórzone zdarzenie zostaje rozpoznane i pominięte, niezależnie od tego, ile razy dotrze.
Nikt nie wie, co się stało
Klient twierdzi, że zamówienie złożył. W systemie go nie ma. Bez logów wymiany danych pozostaje słowo przeciwko słowu.
Jak to robimy: logujemy każde zapytanie i odpowiedź razem z czasem i wynikiem. Dowolną operację da się odtworzyć i wskazać, na którym etapie się zatrzymała.
/kontakt
Opisz problem.
Odpowiemy, jak go rozwiązać.
Krótka rozmowa wystarczy, żeby ocenić zakres, technologię i realny termin. Bez zobowiązań i bez ofert na 40 stron.