Pòłączanié czegòkòlwëk

HTTP wchôd, HTTP wëchôd, kłopotlëwi dzélë òbsłëżoné

Każdé nôrzãdë do aùtomatizacëji chwôli sã lëczbą integracëjów. Lëczba je zawszé wiôlgô i zawszé je to złé pëtanié, bò system, chtërnégò naprawdã pòtrzebùjesz, to ten zbudowóny w domù w 2014 rokù przez kòs, chtëren òdszedł. Wôżné je, jak dôbré nôrzãdë gôdają protokòłã, na chtërnym wszëstczé stoją.

Przëgòtowóné pòłączeniô

Aplikacëje, na chtërnëch nôjbarzë dzôłają fërmë, mają przëgòtowóné krokë: sklepi i marketplace, ksãgòwosc i fakturowanié, tabelë i bazi dónëch, kalendôrze i pòchta, składowanié i wiadë, CRM-i i helpdeski, platné systemë i przewòznicë. Raz zlëcujesz konto, a pòla są nazwóné w jãzëkù, jaczi aplikacëjô brëkùje, a nie w jãzëkù jegò JSON-a.

Gdë aplikacëjô mòcë pòlsczim rink — system fakturowaniô, chtëren mùszi bëc KSeF-przëgòtowóny, przewòznik, chtëreny etiketë są nôrodnym standardã — przëgòtowóny krok ò tim wé, bò familijô sprôwô na tim rinku i mùszała sã tegò naùczëc.

A pòtemù przëpôdk òglowô

Wszëstczé inszé to krok HTTP, a krok HTTP tu nie je marną nôdgrodą. To ta sama machinériô, na chtërny stołé przëgòtowóné pòłączeniô, z tą samą òbsłëgą dzélów, chtërne je mòczącą pisać samémù.

Mòczącą dzélë

Òbsłëżoné, żebë nie pisać jich znowa

Ùwierzëtelnienié

Klucze API, tokenë bearer, basic auth, OAuth 2 z òdnową, pòdpisowanié żądaniów HMAC, wzajemny TLS. Kredencjal je zapisóny raz, wëmieniony przez miono i nigdë nie wëdrëkóny do loga abò zapisu dzéłaniô.

Stronicowanié

Kursorë, numerë stronów, offsetë, nagłówczi Link, i API, chtërne znamionë kùńc przez pòwracanié pùstégò arraya. Pòdôj, jaczi to kształt, a krok przeńdzé całą zbiérkã.

Granice tempa

Lëmit na pòłączenié, szanowóny we wszëtczich workflow, chtërne jégò brëkùją. Gdë dostôwca òdpòwieszi 429 z Retry-After, krok czékô téż dłëgò, zamiast biéc.

Ponowieniô i backoff

Przëleżnoscé félë ponowióné z rosnącym òdstãpã i granicą. Krok je czëstą fùnkcją swòjich wejść, tak że ponowienié znowa pùszczi krok, a nie znowa pùszczi całé dzéłanié.

Kłopotlëwi payloadë

JSON, form encoding, XML, prosti tekst, multipart uploadë. Òdpòwiesczi rozpôrsóné na pòla, chtërné mòżesz wëmienic przez miono, w tim téż te zagnieżdżoné czwiérti raz w dół.

Czasonkë

Lëmit na krok, tak że jeden môłi zôwisłoscé nie mòże trzëmacc worker, pòtemù czedë wszëtkò za nim czékô w kòlce. Cò sã stôwô, gdë lëmit je dosygniãti, to twòjô decëzjô, na krok.

Jeżlë gôdô HTTP, rozmòwa je ju zaczãtô.

Przëchodnąc webhooki, trzëmóné serio

Każdé workflow mòże miec URL, chtëren jegò zaczinô. Ten URL wérifikùje pòdpisë — HMAC w kształtach, jaczich brëkùją pòspólné dostôwce, i wspólną tajemnicã, gdë to je wszëtkò, chtërnégò nadôwca mòże. Niepòdpisóné żądanié do workflow, chtëren czékô na pòdpis, je òdrzuconé i zapisóné, a nie cëchò òbsłëżoné.

Deduplikacjô je na wlasnym identifikatorze payloadu, tak że nadôwca, chtëren ponôwi, bò nie ùzôł twòjégò 200 na czas, dostôwô jedno dzéłanié zamiast trzëch. Zepsłé payloadë są zapisané, z przëczną òdrzuceniô, bò nôczãstszô przëcznô tajemnégò brôkù w aùtomatizacëji to nadôwca, chtëren zmienił mëslã ò pòlu.

Systemë, chtërné gôdają leno CSV

Jistnieją. Plik pòjawia sã na serwerze SFTP ò czwiôrti z rana, abò przëchôdzy jak przëłôczk, abò je zrzucony do wspólnégò katalogù. Workflow mòże na nie czekac, czëtac i trzëmacc kądzé réwkã jak zapis — w tim plik z byte-order mark, pòtdwòpùnkama i nagłówkã pò pòlskù, bò tak naprawdã wëzdrzi eksport.

W drëgą stronã téż dzôłô: workflow mòże złożic plik i pòłożic gò tam, gdze inszé system czékô, chtërné je czãstò jedinym interfejsã softwarë z 2006 rokù.

Nocny dopôwka dostôwcówSFTP → HTTP

⚡Wëzwôlôcz04:02Nowi plik na SFTP dostôwcë: stock-2026-09-09.csv.
2RozpôrsPòtdwòpùnczi, byte-order mark, pòlsczé nagłówczi. 4 118 réwków.
3NormalizacjôKòdë walëtów sprôwdzóné z dónyma referencjowima; dwa òdrzuconé jak niepòprôwné.
4Wëpchni2.9 sHTTP PATCH w paczkach pò 200, granica tempa szanowónô.
!WëjôtkiDwi réwkë zapisané dlô człowieka, z numerã réwkã i przëczną. Inszé 4 116 przeszłé.

Krokë, chtërné wòłalé model: 0Kòszt tegò dzéłaniô: nic

Kòl są pòswiadczënia

Zaszyfrowóné, pòwòłóné pò mianie, ògraniczóné do robòtë, chtërna jich mô, ë nigdë nie zapisóné w logù dzéłaniô, w wiadze ò felerze ani w rozmòwce z pòmòcą. Zapis dzéłaniô pokôzëwô, że krok sã pòswiôdczëł jakno supplier-sftp; nie pokôzëwô, co supplier-sftp je.

Agencëjô, chtërna pòwôdzy jedną robòtã dlô trzëdzescë klientów, dôwô kòżdemù klientowi swòjé zestaw pòswiôdczëniów, a robòta pòwòłëwô zestaw, a nie samą tajemnicã. Zmiana klucza to jeden zëmk w jednym môlu — co je nôwôżniészim pòwòdłã, dlô czegò agencëje tu przëchodzą.

Granica, chtërną wôrt znac: system bez żodnégò interfejsu — bez API, bez webhooka, bez przëdaniô lopków, nic, leno człowiek klëkający w przeglądarce — nie da sã zautomatyzowac tu ani niczim jinym szczerim. Nie ma tu przeglądarki bez głowë, chtërna udôwôłabë brëkòwnika, bo to pòpsëje sã pierszim rôzã, czedë drëgô strona przesënie knąpã, ë pòpsëje sã cëszo.