Systemy można integrować przez API, webhooki, cykliczne odpytywanie albo wymianę plików. Najlepsza metoda zależy od wymaganego czasu reakcji, dostępności danych, wolumenu, bezpieczeństwa i możliwości używanych aplikacji. Nowocześniejszy mechanizm nie zawsze jest lepszy dla konkretnego procesu.
Najpierw określ przepływ danych
Przed wyborem technologii zapisz, które dane mają przechodzić między systemami, w jakim kierunku, jak często i co uruchamia wymianę. Ustal także system nadrzędny dla każdego rodzaju informacji.
Przykładowo CRM może być źródłem prawdy dla opiekuna klienta, ERP dla salda, a sklep dla zawartości koszyka. Bez takiego podziału integracja może nadpisywać poprawne dane starszą wersją.
Kiedy wybrać API?
API pozwala jednemu systemowi odczytywać lub zmieniać dane w drugim w kontrolowany sposób. Sprawdza się, gdy potrzebny jest szybki dostęp do konkretnych rekordów, a dostawca udostępnia stabilną dokumentację.
Przed wdrożeniem trzeba sprawdzić:
- sposób uwierzytelniania i zakres uprawnień,
- limity liczby zapytań,
- obsługiwane operacje i pola,
- stronicowanie dużych zbiorów,
- wersjonowanie API,
- komunikaty błędów,
- środowisko testowe.
Samo istnienie API nie oznacza, że udostępnia ono wszystkie funkcje widoczne w aplikacji.
Webhook — informacja natychmiast po zdarzeniu
Webhook to komunikat wysyłany przez system w momencie zdarzenia, na przykład utworzenia zamówienia lub zmiany statusu płatności. Eliminuje ciągłe pytanie „czy pojawiło się coś nowego?” i pozwala szybko rozpocząć proces.
Odbiorca webhooka powinien potwierdzić przyjęcie, zapisać zdarzenie i przetwarzać je niezależnie. Należy weryfikować podpis wiadomości, odrzucać nieautoryzowane żądania i przygotować się na ponowne wysłanie tego samego zdarzenia.
Cykliczne odpytywanie
Jeżeli system nie wysyła webhooków, integracja może co kilka minut pobierać rekordy zmienione od ostatniej synchronizacji. To proste i często wystarczające dla raportów, danych magazynowych lub procesów, które nie wymagają reakcji w sekundę.
Kluczowe jest zapisywanie punktu ostatniej udanej synchronizacji. Po awarii proces powinien wznowić pracę od bezpiecznego miejsca, a nie pomijać rekordy albo pobierać całą historię.
Kiedy plik ma sens?
CSV, XML lub plik arkusza nadal może być dobrym rozwiązaniem przy cyklicznej wymianie dużej liczby danych z systemem bez API. Warunkiem jest jednoznaczny format, bezpieczny kanał, kontrola kompletności i archiwizacja przetworzonych plików.
Warto ustalić kodowanie, separator, format dat, identyfikatory, zasady pustych pól oraz wersję schematu. Plik błędny nie powinien zostać częściowo zaimportowany bez raportu.
Obsługa błędów jest częścią integracji
Integracja nie kończy się na udanym teście. Trzeba przewidzieć niedostępność systemu, przekroczenie limitu, zmianę danych, duplikat i częściowe wykonanie procesu.
Bezpieczny mechanizm wykorzystuje ponowienia z rosnącym odstępem, identyfikatory zapobiegające duplikatom, dziennik operacji oraz kolejkę przypadków wymagających człowieka. Alert powinien zawierać kontekst biznesowy, a nie tylko kod błędu.
Jak dokonać wyboru?
Webhook jest dobry do szybkiej reakcji na zdarzenie. API nadaje się do pobrania szczegółów i wykonania działania. Polling sprawdza się, gdy kilka minut opóźnienia jest akceptowalne. Plik jest rozsądnym kanałem dla wsadowej wymiany z systemem starszego typu.
W praktyce jeden proces często łączy kilka metod: webhook uruchamia przepływ, API pobiera szczegóły, a nocny plik służy do uzgodnienia danych. Liczy się niezawodność całego procesu, nie nazwa technologii.