Integracje API
Integracja API przenosi dane i działania między systemami, z których firma już korzysta — tak, żeby pracownicy nie przepisywali tych samych informacji z jednego programu do drugiego. Zamówienie, klient, dokument albo zmiana statusu pojawia się tam, gdzie jest potrzebna, w momencie, w którym powinna. Dobrze zaprojektowana integracja wie też, co zrobić, gdy po drugiej stronie coś przestaje działać.
INTEVO Sp. z o.o. · Aktualizacja:
API (interfejs programistyczny) to uzgodniony sposób, w jaki system udostępnia dane i operacje innym programom. Integracja API to połączenie, które z tego korzysta: pobiera, wysyła albo aktualizuje dane w odpowiedzi na zdarzenie — nowe zamówienie, zatwierdzony dokument, zmianę statusu.
Każda integracja odpowiada na cztery pytania:
Wspólny sygnał: ktoś regularnie przepisuje dane z jednego systemu do drugiego albo sprawdza w kilku miejscach, czy coś się już wydarzyło. Typowe połączenia:
Integracja ma sens wtedy, gdy oba systemy zostają w firmie na dłużej, a przepływ powtarza się na tyle często, że ręczna praca i błędy przy przepisywaniu realnie kosztują.
Te pojęcia często się mieszają, a odpowiadają na różne problemy. Żadne nie jest lepsze samo w sobie — dobry wybór wynika z procesu, a w praktyce często łączy wszystkie trzy.
Łączy istniejące systemy. Każdy robi to, co robił, ale dane między nimi przepływają same. Dobra, gdy narzędzia są właściwe, tylko nie rozmawiają ze sobą.
Steruje powtarzalnymi działaniami i przejściami w procesie: kto, kiedy i pod jakim warunkiem wykonuje następny krok. Może korzystać z integracji, ale dotyczy przebiegu pracy.
Sam staje się miejscem pracy i procesem: ma własne stany, role, dane i historię. Ma sens, gdy łączenie kolejnych narzędzi przestaje wystarczać.
Połączenie systemów można zbudować w kodzie albo na platformie automatyzacji. Kiedy które podejście ma sens, opisujemy w artykule Make, n8n, Zapier czy dedykowany system.
Cztery działające systemy opisane od strony przepływu danych: jakie systemy biorą udział, co się między nimi przemieszcza i co jest pod kontrolą. Frovo pokazuje drugą stronę decyzji — sprzedaż i zaplecze działają w jednym systemie, więc nie trzeba ich integrować.
Połączenie dwóch systemów zwykle działa w demonstracji. Problemy pojawiają się później — przy większym ruchu, zmianie po stronie dostawcy albo pierwszej awarii. Dlatego te sytuacje projektujemy od początku:
Jak obsłużyć timeouty, ponowienia, duplikaty webhooków i operacje wykonane w połowie, opisujemy w artykule o tym, jakie są najczęstsze problemy integracji API i jak projektować integracje odporne na błędy.
Brak API nie zawsze zamyka temat. Realne możliwości, od najprostszych:
Najpierw dane i odpowiedzialność, potem kod:
01
Które pola, w jakim formacie i co znaczą po obu stronach — łącznie z wyjątkami.
02
Który system decyduje o danym rekordzie, a który tylko go odbiera.
03
Zdarzenie, harmonogram albo decyzja człowieka — i jak często przepływ ma działać.
04
Kolejka, ponowienia, ochrona przed duplikatami i informacja dla właściwej osoby.
05
Integracja jako część procesu, z uprawnieniami ograniczonymi do potrzebnego zakresu.
06
Widać, co przeszło, co czeka i co się nie udało — bez szukania w logach serwera.
07
Kolejne zmiany wynikają z tego, jak integracja zachowuje się w realnym ruchu.
Jeśli przepływ dotyczy dokumentów — protokołów, wniosków, akceptacji — zobacz też, jak podchodzimy do cyfryzacji dokumentów.
Opisz, które systemy biorą udział w procesie i co jest między nimi przenoszone. Odpowiemy na piśmie, czy wystarczy integracja, gdzie są ryzyka i od czego zacząć.
API to uzgodniony sposób, w jaki jeden program udostępnia dane i operacje innym programom: co można pobrać lub wysłać, w jakim formacie i z jakimi uprawnieniami. Dzięki temu systemy wymieniają informacje bez udziału człowieka.
Nie zawsze w ten sam sposób. System z udokumentowanym API zwykle da się podłączyć bezpośrednio. Bez API zostają importy i eksporty, webhooki, kontrolowana wymiana plików albo — gdy to dozwolone — integracja na poziomie bazy danych. Czasem rozsądniej jest zastąpić narzędzie niż je obchodzić.
Sprawdzamy, co system oferuje: eksport do pliku, import, powiadomienia o zdarzeniach albo dostęp do bazy. Automatyzacja przeglądarki wchodzi w grę tylko wtedy, gdy jest uzasadniona i dozwolona przez dostawcę. Jeśli każda z dróg jest krucha, rekomendujemy zmianę narzędzia.
Nie. Integracja łączy systemy, a nie przejmuje ich funkcji. ERP nadal prowadzi swoje obszary, a CRM — relacje i sprzedaż. Integracja dba o to, żeby dane między nimi się zgadzały i nie trzeba było ich przepisywać.
Osobne konta techniczne z minimalnymi uprawnieniami, klucze i tokeny przechowywane poza kodem i możliwe do wymiany, szyfrowane połączenie, logi operacji bez zapisywania wrażliwych danych oraz ograniczenie, kto może zmieniać konfigurację integracji.
Dobrze zaprojektowana integracja nie gubi danych: operacja czeka w kolejce, jest ponawiana z odstępami, a po kilku nieudanych próbach ktoś dostaje informację. Ponowienie nie może utworzyć duplikatu, dlatego operacje projektuje się tak, żeby ich powtórzenie dawało ten sam wynik.
