Usługi
Niezawodne API, importy, eksporty i wymiana danych między systemami, z których firma już korzysta.
Integracja to więcej niż żądanie i odpowiedź JSON. Łączy działanie biznesowe z innym systemem: zapytanie ze strony staje się sprawą w CRM, zamówienie trafia do ERP, operator potwierdza płatność, a księgowość zwraca status faktury.
Przed wyborem endpointu trzeba ustalić, co ma się wydarzyć, który system posiada dane, kto może wykonać akcję i co zrobi zespół, gdy usługa zewnętrzna przestanie odpowiadać. Integracja ma wartość tylko wtedy, gdy proces pozostaje zrozumiały w normalnej pracy, podczas timeoutu, powtórzonego żądania i częściowej awarii.
Kontrakt API opisuje wymagane dane, dostępne operacje, uwierzytelnienie, format odpowiedzi, błędy i wersjonowanie. Aplikacja powinna wyrażać operację biznesową, a wydzielona warstwa integracyjna tłumaczyć ją na język dostawcy. Dzięki temu szczegóły CRM, płatności czy księgowości nie przenikają do niezwiązanych modułów zamówień, supportu i raportowania.
Taka granica ogranicza zakres zmian. Nowy dostawca albo zmieniona wersja API dotyka jednego obszaru, w którym można sprawdzić kontrakt, mapowanie i obsługę błędów.
Synchronizacja dwukierunkowa staje się zawodna, gdy dwa systemy uznają się za właściciela tej samej wartości. Dla każdego pola biznesowego warto określić źródło prawdy: na przykład CRM dla danych kontaktowych, księgowość dla faktur, CMS dla opublikowanej treści, a ERP lub magazyn dla stanów.
Aktualizacja jednokierunkowa może być prosta. Dwukierunkowa wymaga reguły konfliktu. Gdy CRM i ERP niezależnie zmienią telefon, samo połączenie nie wskaże właściwej wartości. Reguła może wybrać system właścicielski, porównywać znaczniki czasu w zdefiniowanych warunkach albo kierować konflikt do przeglądu. Trzeba ją uzgodnić przed produkcją, nie dopiero po rozbieżności danych.
Przed wywołaniem zewnętrznym aplikacja powinna sprawdzić znane warunki: tożsamość klienta, stan zamówienia, walutę, uprawnienia i wymagane dokumenty. Potem waliduje odpowiedź jako dane zewnętrzne. HTTP 200 może oznaczać przyjęcie żądania, ale nie zawsze dowodzi utworzenia faktury, rozliczenia płatności czy zakończenia zamówienia.
Timeout tworzy szczególnie ważny stan niepewności. Zewnętrzny system mógł wykonać operację, lecz odpowiedź została utracona. Przy wysyłaniu zapytania do CRM bezpieczny workflow zapisuje lokalną próbę, używa trwałego identyfikatora żądania lub zdarzenia, jeśli dostawca go obsługuje, sprawdza stan po stronie zewnętrznej, gdy jest to możliwe, i pokazuje nierozstrzygnięte przypadki pracownikowi.
Idempotencja oznacza, że powtórzone żądanie nie wywołuje dodatkowego zamierzonego skutku biznesowego. Zależy od projektu aplikacji oraz, gdy to potrzebne, wsparcia dostawcy lub wspólnego identyfikatora. Ogranicza ryzyko duplikacji, ale nie jest uniwersalną gwarancją.
Wywołanie synchroniczne pasuje do krótkiej interakcji, w której użytkownik potrzebuje natychmiastowej, ograniczonej odpowiedzi, na przykład sprawdzenia dostępności. Importy, transfer dokumentów, masowa synchronizacja i wolni dostawcy zwykle powinny działać w zadaniach w tle. Aplikacja zapisuje pracę, pokazuje jej status i może działać dalej mimo opóźnienia po stronie zewnętrznej.
Webhook informuje aplikację, że coś zdarzyło się w innym systemie, na przykład przyszło potwierdzenie płatności. Trzeba zweryfikować podpis lub inne uwierzytelnienie, sprawdzić dane, rozpoznać duplikaty i przetworzyć zdarzenie przez ten sam kontrolowany workflow. Odebranie webhooka nie dowodzi jeszcze, że wszystkie dalsze kroki biznesowe się zakończyły.
Ponowienia powinny być ograniczone i dotyczyć błędów chwilowych. Trwały błąd walidacji wymaga poprawy danych, nie kolejnego ruchu. Gdy dostawca jest stale niedostępny, circuit breaker lub czasowe wstrzymanie może chronić aplikację i pozwolić zespołowi zdecydować o wznowieniu. Odzyskanie może oznaczać ponowienie, uzgodnienie stanu ze źródłem, akcję kompensującą albo obsługę ręczną, zależnie od tego, co już zaszło.
Używaj minimalnych uprawnień i danych potrzebnych do celu. Sekrety przechowuj w odpowiedniej konfiguracji, ograniczaj dostęp według roli i organizacji, korzystaj z bezpiecznego transportu, a danych osobowych i finansowych nie zapisuj w logach bez uzasadnienia i ochrony. Uwierzytelnienie potwierdza tożsamość wywołującego; autoryzacja określa, co może zrobić.
Monitoring powinien pokazywać więcej niż błędy techniczne: oczekujące importy, błędne płatności, opóźnione zadania, konflikty synchronizacji i rekordy wymagające przeglądu. Audyt łączący rekord lokalny, identyfikator zewnętrzny, status żądania i końcowy rezultat biznesowy ułatwia support i uzgadnianie danych.
System legacy nie potrzebuje pełnego rewrite’u, aby integrować się niezawodnie. W Symfony lub PHP niewielka usługa integracyjna może zamknąć klienta zewnętrznego, mapowanie, walidację i obsługę błędów. Testy charakteryzujące chronią znane zachowanie przed zmianą połączenia. Import przyrostowy i stopniowe przejście ograniczają ryzyko, gdy jakość danych lub ich własność są niepewne.
Usługi AI można podłączyć przez tę samą granicę, ale proporcjonalnie do procesu: przekazywać ograniczony, zatwierdzony kontekst, walidować wyniki strukturalne, a uprawnienia i końcowe działania pozostawić aplikacji.
GiSoft projektuje i poprawia integracje API wokół procesów, które mają znaczenie: CRM, ERP, płatności, księgowość, importy i usługi partnerów. Ustalamy własność oraz kontrakty, budujemy bezpieczną ścieżkę operacyjną i czynimy błędy widocznymi. Właściwy projekt zależy od systemów, wolumenu, danych i konsekwencji biznesowych; celem jest niezawodna wymiana, nie obietnica bezawaryjności usług zewnętrznych.
