Pripojenie čohokoľvek

HTTP dnu, HTTP von, nepríjemné časti vyriešené

Každý automatizačný nástroj inzeruje počet integrácií. Ten je vždy veľký a vždy je to nesprávna otázka, pretože systém, ktorý skutočne potrebujete, je ten postavený na mieru v roku 2014 niekým, kto odišiel. Dôležité je, ako dobre nástroj hovorí protokolom, ktorý sa skrýva pod všetkými z nich.

Hotové pripojenia

Aplikácie, na ktorých beží väčšina firiem, majú pripravené kroky: obchody a marketplace, účtovníctvo a fakturácia, tabuľky a databázy, kalendáre a pošta, úložiská a messaging, CRM a helpdesky, platobní poskytovatelia a dopravcovia. Účet autorizujete raz a polia sú pomenované v jazyku, ktorý aplikácia používa, nie v jazyku jej JSONu.

Ak má aplikácia osobitosť poľského trhu — fakturačný systém, ktorý musí byť pripravený na KSeF, dopravca, ktorého štítky sú národným štandardom — pripravený krok o tom vie, pretože rodina na tento trh predáva a musela sa to naučiť.

A potom všeobecný prípad

Všetko ostatné je HTTP krok, a HTTP krok tu nie je útechou. Je to rovnaká mechanika, na ktorej sú postavené hotové pripojenia, s rovnakým spracovaním častí, ktoré je zdĺhavé písať si sám.

Té zdlžhavé časti

Sú vyriešené, takže ich nemusíte písať znova

Autentifikácia

API kľúče, bearer tokeny, basic auth, OAuth 2 s obnovou, podpisovanie požiadaviek HMAC, vzájomné TLS. Prihlasovací údaj sa uloží raz, odkazuje sa naň menom a nikdy sa nevypíše do logu ani záznamu o behu.

Stránkovanie

Kurzorové tokeny, čísla stránok, offsety, hlavičky Link a API, ktoré koniec signalizuje vrátením prázdneho poľa. Povedzte, o aký tvar ide, a krok prejde celou množinou.

Limity počtu požiadaviek

Strop na jedno pripojenie, rešpektovaný vo všetkých workflow, ktoré ho používajú. Keď poskytovateľ odpovie 429 s hlavičkou Retry-After, krok čaká presne tak dlho, namiesto aby bombardoval.

Opakovania a spomalenie

Prechodné zlyhania sa opakujú s rastúcim odstupom a horným limitom. Krok je čistá funkcia svojich vstupov, takže opakovanie znovu spustí krok, nie celý beh.

Náročné dátové formáty

JSON, kódovanie formulárov, XML, čistý text, nahrávanie multipart. Odpovede sa rozparsujú do polí, na ktoré sa môžete odkazovať menom, vrátane tých vnorených štyri úrovne hlboko.

Časové limity

Limit na každý krok, takže jeden pomalý závislý systém nemôže zablokovať pracovníka, kým sa za ním hromadí fronta. Čo sa stane po dosiahnutí limitu, je vaše rozhodnutie, pre každý krok zvlášť.

Ak hovorí HTTP, rozhovor už začal.

Prichádzajúce webhooky, brané vážne

Každý workflow môže mať URL, ktorá ho spustí. Táto URL overuje podpisy — HMAC v tvaroch, aké používajú bežní poskytovatelia, a zdieľaný tajný kľúč tam, kde to je všetko, čo odosielateľ zvládne. Nepodpísaná požiadavka na workflow, ktorý podpis očakáva, sa odmietne a zaznamená, nie ticho spracuje.

Deduplikácia sa riadi vlastným identifikátorom dát, takže odosielateľ, ktorý opakuje, pretože vaše 200 nestihol zaznamenať, dostane jeden beh namiesto troch. Poškodené dátové sady sa uchovajú spolu s dôvodom odmietnutia, pretože najčastejšou príčinou záhadnej medzery v automatizácii je odosielateľ, ktorý si o poli rozmyslel názor.

Systémy, ktoré hovoria len CSV

Existujú. Súbor sa o štvrtej ráno objaví na SFTP serveri, príde ako príloha, alebo sa vloží do zdieľaného priečinka. Workflow ho môže sledovať, prečítať a spracovať každý riadok ako záznam — vrátane súboru s byte-order mark, bodkočiarkovými oddeľovačmi a hlavičkou v poľštine, pretože presne tak vyzerá ten export.

Funguje to aj opačne: workflow môže zostaviť súbor a umiestniť ho tam, kde ho druhý systém očakáva, čo je často jediné rozhranie, ktoré softvér z roku 2006 má.

Nočný feed od dodávateľaSFTP → HTTP

⚡Spúšťač04:02Nový súbor na SFTP dodávateľa: stock-2026-09-09.csv.
2ParsovanieBodkočiarky, byte-order mark, poľské hlavičky. 4 118 riadkov.
3NormalizáciaKódy mien overené voči referenčným dátam; dva odmietnuté ako neplatné.
4Odoslať2.9 sHTTP PATCH v dávkach po 200, limit požiadaviek rešpektovaný.
!VýnimkyDva riadky odoslané na posúdenie človeku, s číslom riadku a dôvodom. Ostatných 4 116 prešlo.

Kroky, ktoré volali model: 0Náklady na tento beh: nič

Kde bývajú prihlasovacie údaje

Šifrované, odkazované menom, obmedzené na workspace, ktorý ich vlastní, a nikdy nezobrazené v logu behu, chybovej hláške ani v konverzácii s podporou. Záznam o behu ukáže, že krok sa overil ako supplier-sftp; neukáže, čo supplier-sftp je.

Agentúra, ktorá prevádzkuje jeden workflow pre tridsať klientov, dá každému klientovi vlastnú sadu prihlasovacích údajov a workflow sa odkazuje na sadu, nie na tajomstvo. Výmena kľúča je jedna úprava na jednom mieste — čo je hlavný dôvod, prečo agentúry sem prichádzajú.

Limit, ktorý stojí za to poznať: systém bez akéhokoľvek rozhrania — žiadne API, žiadny webhook, žiadne odovzdávanie súborov, nič okrem človeka klikajúceho v prehliadači — nie je možné touto ani žiadnou inou poctivou metódou automatizovať. Tu nie je žiadny headless browser predstierajúci používateľa, pretože ten sa pokazí v momente, keď druhá strana presunie tlačidlo, a pokazí sa potichu.