Połączenia
HTTP tam i z powrotem,bez niewygodnych miejsc.
Każde narzędzie do automatyzacji chwali się liczbą integracji. Liczba zawsze jest duża i zawsze jest złym pytaniem, bo systemem, którego naprawdę potrzebujesz, jest ten napisany w firmie w 2014 roku przez kogoś, kto już tu nie pracuje. Liczy się to, jak dobrze narzędzie mówi protokołem leżącym pod tym wszystkim.
Gotowe połączenia
Aplikacje, na których stoi większość firm, mają przygotowane kroki: sklepy i marketplace'y, księgowość i fakturowanie, arkusze i bazy, kalendarze i poczta, dyski i komunikatory, CRM-y i helpdeski, operatorzy płatności i firmy kurierskie. Konto autoryzujesz raz, a pola nazywają się tak, jak w danej aplikacji, a nie tak, jak w jej JSON-ie.
Tam, gdzie aplikacja ma polską specyfikę — system fakturowy, który musi być gotowy na KSeF, kurier z krajowym standardem etykiet — gotowy krok o tym wie, bo rodzina sprzedaje na tym rynku i musiała się tego nauczyć.
A potem przypadek ogólny
Cała reszta to krok HTTP, a krok HTTP nie jest tutaj nagrodą pocieszenia. To ta sama maszyneria, na której zbudowane są gotowe połączenia, z tą samą obsługą tych fragmentów, które nudno jest pisać samemu.
Nudne fragmenty
Obsłużone,
żebyś nie pisał ich po raz kolejny.
Uwierzytelnianie
Klucze API, tokeny bearer, basic auth, OAuth 2 z odświeżaniem, podpisywanie żądań HMAC, wzajemne TLS. Dane dostępowe zapisuje się raz, odwołuje po nazwie i nigdy nie trafiają do dziennika ani do zapisu przebiegu.
Stronicowanie
Kursory, numery stron, przesunięcia, nagłówek Link i API, które sygnalizuje koniec, zwracając pustą tablicę. Powiedz, który to kształt, a krok przejdzie cały zbiór.
Limity zapytań
Pułap na połączenie, respektowany przez wszystkie procesy, które go używają. Gdy dostawca odpowie 429 z nagłówkiem Retry-After, krok czeka tyle, ile trzeba, zamiast dobijać się dalej.
Ponowienia
Przejściowe błędy ponawiane z narastającą przerwą i limitem. Krok jest funkcją czystą swoich danych wejściowych, więc ponowienie powtarza krok, a nie cały przebieg.
Niewygodne ładunki
JSON, formularze, XML, zwykły tekst, przesyłanie plików. Odpowiedzi rozkładane na pola dostępne po nazwie — również te zagnieżdżone na czwartym poziomie.
Limity czasu
Ograniczenie na krok, żeby jedna wolna zależność nie blokowała procesu roboczego, gdy wszystko za nim czeka. Co się dzieje po przekroczeniu, decydujesz sam, osobno dla każdego kroku.
Jeśli mówi po HTTP,
rozmowa już się zaczęła.
Webhooki przychodzące,
potraktowane poważnie.
Każdy proces może mieć adres, który go uruchamia. Ten adres weryfikuje podpisy — HMAC w wariantach używanych przez popularnych dostawców i wspólny sekret tam, gdzie nadawca nie potrafi więcej. Niepodpisane żądanie do procesu, który oczekuje podpisu, jest odrzucane i zapisywane, a nie po cichu przetwarzane.
Odróżnianie odbywa się po identyfikatorze z samego ładunku, więc nadawca ponawiający, bo nie zobaczył Twojego 200 w czasie, dostaje jeden przebieg, a nie trzy. Uszkodzone ładunki są zachowywane razem z powodem odrzucenia, bo najczęstszą przyczyną tajemniczej luki w automatyzacji jest nadawca, który zmienił zdanie co do jednego pola.
Systemy,
które mówią wyłącznie CSV.
One istnieją. Plik pojawia się na serwerze SFTP o czwartej nad ranem, przychodzi jako załącznik albo ląduje w udostępnionym katalogu. Proces może go wypatrywać, odczytać i potraktować każdy wiersz jako rekord — łącznie z plikiem ze znacznikiem BOM, średnikami i polskimi nagłówkami, bo tak właśnie wygląda ten eksport.
W drugą stronę też: proces potrafi złożyć plik i położyć go tam, gdzie drugi system się go spodziewa, co często jest jedynym interfejsem, jaki ma oprogramowanie z 2006 roku.
- ⚡WyzwalaczNowy plik na SFTP dostawcy:
stany-2026-09-09.csv. - 2OdczytŚredniki, znacznik BOM, polskie nagłówki. 4118 wierszy.
- 3NormalizacjaKody walut sprawdzone w danych referencyjnych; dwa wiersze odrzucone.
- 4Wysłanie
PATCHpaczkami po 200, limit zapytań respektowany. - !WyjątkiDwa wiersze odłożone dla człowieka, z numerem wiersza i powodem. Pozostałe 4116 przeszło.
Kroków wołających model: 0Koszt przebiegu: zero
Gdzie mieszkają dane dostępowe.
Zaszyfrowane, dostępne po nazwie, przypisane do przestrzeni roboczej, która je posiada, i nigdy nierenderowane do dziennika przebiegu, komunikatu błędu ani rozmowy ze wsparciem. Zapis przebiegu pokazuje, że krok uwierzytelnił się jako supplier-sftp; nie pokazuje, czym jest supplier-sftp.
Agencja prowadząca jeden proces dla trzydziestu klientów daje każdemu z nich własny zestaw danych, a proces odwołuje się do zestawu, nie do sekretu. Rotacja klucza to jedna zmiana w jednym miejscu — i to głównie dlatego agencje tu przychodzą.
Ograniczenie warte poznania: systemu, który nie ma żadnego interfejsu — ani API, ani webhooka, ani wymiany plików, tylko człowieka klikającego w przeglądarce — nie zautomatyzuje ani to narzędzie, ani żadne inne, które jest uczciwe. Nie ma tu przeglądarki udającej użytkownika, bo taka rzecz psuje się przy pierwszym przesunięciu przycisku po drugiej stronie — i psuje się po cichu.