castomFLOW

Podłōnczanie czegokolwiek

HTTP we, HTTP wy, kłopotliwe kōnszty załatwiōne

Każdy autōmatyzacyjny tool chwali sie liczba integracyjōw. Ta liczba je zawsze wielka i zawsze je to złyj pytanio, bo systym, kerego naprawde potzrzebujesz, to ten zbudowany we wewnōtrz w 2014 ôd kajś, kery już ôdszedł. Liczy sie, jak dobrze tool gŏdo protokołym, co leży pod wszyszkimi tymi integracyjami.

Gotowe połōnczynia

Aplikacyje, na kerych wiynkszość firm robi, majōm przygotowane kroki: sklepy i marketplace'y, ksiygowość i faktury, tabele i bazy danych, kalenderze i poczta, składowanie i wiadōmości, CRM-y i helpdeski, płatności i przewoźniki. Autoryzujesz konto jednorŏz i pola sōm nazwane tym gŏdkym, kerym aplikacyjo gŏdo, a nie tym, kerym gŏdo jej JSON.

Kiedy aplikacyjo ma polskõ specyfika — systym faktur, co musi być gotowy na KSeF, przewoźnik, kerego etykiety sōm nacyjnym standardym — przygotowany krok to wie, bo ta familijo sprzŏwŏ na ty rynek i musiała sie tego nauczyć.

A potym przypadek ogōlny

Wszystko inksze to krok HTTP, a krok HTTP tu niy jest nagrodōm pocieszajōncōm. To ta sama maszyneria, na kerej zbudowane sōm gotowe połōnczynia, z tym samym ôbsugōm czynści, co sie niy chce pisać samemu.

Nudne czynści

Ôbsłużone, cobyś ich niy musioł pisać drugi rŏz

Autentykacyjŏ

Klucze API, tokeny bearer, basic auth, OAuth 2 z refreshym, podpisywanie żōndań HMAC, wzajymny TLS. Dana dostympowa je składowana jednorŏz, wywołowanŏ po mianie i nigdy niy drukowanŏ do loga ani do rekordu przebiegu.

Paginacyjŏ

Kursory, numery strōn, offsety, nagłówki Link, i API, co znaczy kōniec ôddajōnc pusty array. Powiedz, jaki to kształt, a krok przejdzie cołki zbiōr.

Limity zapytań

Limit na połōnczynie, respektowany we kożdym workflowu, co go używŏ. Kiedy dostŏwca ôdpadzie 429 z Retry-After, krok czekŏ tyle, a niy wali dalij.

Ponowienia i backoff

Przejściowe porażki sōm ponawiane ze rosnōncym ôdstympym i limitym. Krok to czysto funkcyjŏ swoich wejść, więc ponowienie ôdpŏłŏ krok, a niy cołki przebieg.

Niewygodne payloady

JSON, kodowanie formularzōw, XML, goły tekst, uploady multipart. Ôdpowiedzi rozparowane na pola, kere możesz wywołać po mianie, tyż te zagnieźdżōne cztery poziomy niżej.

Timeouty

Limit na krok, coby jedno wolne zŏleżność niy trzimŏła robota, a wszystko za nim stŏwŏłŏ w kolejce. Co sie stanie, jak limit ôsiōngniesz, decydujesz ty, na kożdy krok.

Jak gŏdŏ HTTP, to rozmowa już sie zaczła.

Przychodzōnce webhooki, traktowane na serio

Kożdy workflow może mieć URL, co go zaczynŏ. Ten URL weryfikuje podpisy — HMAC we kształtach, kerych używajōm pospolite dostŏwcy, i wspōlny sekret, tam gdzie to wszystko, co nadŏwca umie. Podpisane niy żōndanie do workflowu, co ôczekuje podpisu, je ôdrzucane i zapisywane, a niy cichaczem ôbsłużone.

Deduplikacyjo idzie po własnym identyfikatorze payloadu, więc nadŏwca, co ponowi, bo niy zobŏczōł na czas twojego 200, dostŏwŏ jedyn przebieg, a niy trzi. Zepsute payloady sōm zachowane, z powodym ôdrzucynia, bo nojpospolitszŏ przyczyna tajemniczyj dziury we autōmatyzacyji to nadŏwca, co zmiani zdanie ô jakimś polu.

Systymy, co gŏdajōm ino CSV

Take istnijōm. Plik pojawio sie na serwerze SFTP ô czwōrtyj rano, abo przichodzi za przidŏwka do maila, abo jest zrzucony do wspōlnego folderu. Workflow może go ôbserwować, przeczytać i traktować kożdy wiersz za rekord — tyż plik z byte-order mark, średnikami za separatory i nagłówkami po polsku, bo tak naprawde wyglŏdŏ ten eksport.

W drugōm strōnie tyż działa: workflow może złożyć plik i położyć go tam, gdzie drugi systym ôczekuje go znŏleźć, a to często jedyny interfejs, jaki ma softwara z 2006.

Nocny feed dostŏwcySFTP → HTTP
  • ⚡WyzwalŏczNowy plik na SFTP dostŏwcy: stock-2026-09-09.csv.
  • 2ParsowanieŚredniki, byte-order mark, polske nagłówki. 4 118 wierszy.
  • 3NormalizacyjoKody walut sprŏwdzone ze danymi referencyjnymi; dwa ôdrzucone za niyvalidne.
  • 4WypchnijHTTP PATCH w paczkach po 200, limit zapytań respektowany.
  • !WyjōntkiDwa wiersze zafajlowane dlŏ człowieka, z numerym wiersza i powodym. Inksze 4 116 przeszły.

Kroki, co wywołŏły model: 0Koszt tygo przebiegu: nic

Gdzie mieszkajōm dane dostympowe

Zaszyfrowane, wywoływane po mianie, ograniczone do workspace'a, co je posiodŏ, i nigdy nie renderowane do loga przebiegu, wiadōmości ô błyndzie ani rozmowy ze supportym. Rekord przebiegu pokŏzuje, iże krok autoryzowoł sie za supplier-sftp; niy pokŏzuje, co supplier-sftp jest.

Agencja, co robi jedyn workflow dlŏ trzydziestu klijentōw, dŏwŏ kożdym klijentowi własny zbiōr danych dostympowych, a workflow ôdnosi sie do zbioru, a niy do sekretu. Rotacyjo klucza to jedna edycyjo na jednym miejscu — co je wiynkszōm przyczynōm, czo agencje tu przichodzōm.

Granica, co warto znać: systym bez żodnyj interfejsu — bez API, bez webhooka, bez zrzutu pliku, nic ino człowiek klikajōncy w przeglōndarce — niy da sie zautomatyzować ani tym, ani niczym inkszym uczciwym. Tu niy ma przeglōndarki bez głowy, co udaje używacza, bo taka rozłazi sie za piyrszym razym, jak tamci przesunōm knefel, a rozłazi sie po cichu.