Bármi csatlakoztatása
HTTP be, HTTP ki, a kellemetlen részek kezelve
Minden automatizálási eszköz integrációk számát hirdeti. A szám mindig nagy, és mindig rossz kérdés, mert a rendszer, amelyre Önnek ténylegesen szüksége van, az, amelyet 2014-ben valaki házon belül épített, és aki azóta távozott. Az számít, mennyire jól beszéli az eszköz az alattuk álló protokollt.
A kész kapcsolatok
A legtöbb vállalkozás által használt alkalmazásokhoz előkészített lépések tartoznak: webáruházak és piacterek, könyvelés és számlázás, táblázatok és adatbázisok, naptárak és levelezés, tárhelyek és üzenetküldés, CRM-ek és helpdeskek, fizetési szolgáltatók és szállítók. A fiókot egyszer hitelesíti, és a mezők az alkalmazás által használt nyelven vannak elnevezve, nem a JSON nyelvén.
Ahol egy alkalmazásnak lengyel piaci sajátossága van — egy KSeF-kompatibilis számlázórendszer, egy fuvarozó, akinek a címkéi nemzeti szabvány —, az előkészített lépés tud róla, mert a család arra a piacra értékesít, és meg kellett tanulnia.
És aztán az általános eset
Minden más egy HTTP-lépés, és itt a HTTP-lépés nem vigaszdíj. Ugyanaz a gépezet, amelyre a kész kapcsolatok épülnek, ugyanazzal a kezeléssel azoknál a részeknél, amelyeket unalmas lenne magának megírnia.
A kellemetlen részek
Kezelve, hogy Önnek ne kelljen újra megírnia őket
Hitelesítés
API-kulcsok, bearer tokenek, basic auth, OAuth 2 frissítéssel, HMAC kérésaláírás, kölcsönös TLS. A hitelesítő adatot egyszer tároljuk, név szerint hivatkozunk rá, és soha nem kerül naplóba vagy futásrekordba.
Lapszámozás
Kurzorok, oldalszámok, offsetek, Link fejlécek, és az az API, amely üres tömb visszaadásával jelzi a végét. Mondja meg, milyen formájú, és a lépés végigjárja a teljes halmazt.
Sebességkorlátok
Kapcsolatonkénti felső korlát, amelyet minden azt használó munkafolyamat betart. Ha a szolgáltató 429-es válasszal és Retry-After fejléccel tér vissza, a lépés megvárja a megadott időt, ahelyett hogy nyomkodná.
Újrapróbálkozás és visszafogás
Az átmeneti hibák növekvő szünettel és felső határral kerülnek újrapróbálásra. Egy lépés a bemeneteinek tiszta függvénye, így az újrapróbálkozás a lépést futtatja újra, nem a teljes futást.
Kényes hasznos terhek
JSON, űrlapkódolás, XML, sima szöveg, multipart feltöltés. A válaszok név szerint hivatkozható mezőkké alakulnak, a négy szinttel mélyebben beágyazottak is.
Időkorlátok
Lépésenkénti korlát, így egy lassú függőség nem tarthatja fogva a munkavégzőt, miközben minden mögötte sorakozik. Mi történik a korlát elérésekor, azt Ön dönti el, lépésenként.
Ha beszéli a HTTP-t, a beszélgetés már elkezdődött.
Bejövő webhookok, komolyan véve
Minden munkafolyamathoz tartozhat egy URL, amely elindítja. Az URL ellenőrzi az aláírásokat — HMAC-ot a gyakori szolgáltatók által használt formákban, és megosztott titkot ott, ahol ennél többre a küldő nem képes. Az aláírást váró munkafolyamathoz érkező aláíratlan kérés elutasításra kerül és rögzítésre kerül, nem csendben feldolgozva.
A deduplikáció a hasznos teher saját azonosítóján alapul, így az a küldő, amely újrapróbálkozik, mert nem látta időben az Ön 200-as válaszát, egy futást kap, nem hármat. A hibásan formázott hasznos terhek megőrzésre kerülnek az elutasítás okával együtt, mert az automatizálás rejtélyes hiányának leggyakoribb oka egy küldő, amely meggondolta magát egy mezőt illetően.
A rendszerek, amelyek csak CSV-t beszélnek
Léteznek. Egy fájl megjelenik egy SFTP-szerveren hajnali négykor, vagy mellékletként érkezik, vagy egy megosztott mappába kerül. Egy munkafolyamat ráfigyelhet, kiolvashatja, és minden sort rekordként kezelhet — beleértve azt a fájlt is, amely bájtsorrend-jelölőt, pontosvessző-elválasztót és lengyel fejlécsort tartalmaz, mert pontosan így néz ki az export.
Fordítva is működik: egy munkafolyamat összeállíthat egy fájlt, és oda helyezheti, ahová a másik rendszer várja — ez gyakran az egyetlen felülete egy 2006-os szoftvernek.
- ⚡EseményindítóÚj fájl a beszállító SFTP-jén:
stock-2026-09-09.csv. - 2FeldolgozásPontosvesszők, bájtsorrend-jelölő, lengyel fejlécek. 4 118 sor.
- 3NormalizálásA pénznemkódok ellenőrizve a referenciaadatok alapján; kettő érvénytelenként elutasítva.
- 4FeltöltésHTTP
PATCH200-as kötegekben, a díjkorlát betartásával. - !KivételekKét sor egy személyhez rendelve, a sorszám és az indoklás feltüntetésével. A másik 4 116 átfutott.
Modellt meghívó lépések: 0A futás költsége: semmi
A hitelesítő adatok helye
Titkosítva, név szerint hivatkozva, a tulajdonos munkaterületre korlátozva, és soha nem jelennek meg futási naplóban, hibaüzenetben vagy támogatási beszélgetésben. Egy futási rekord azt mutatja, hogy a lépés supplier-sftp néven hitelesített; azt nem mutatja meg, mi az a supplier-sftp.
Egy ügynökség, amely egyetlen munkafolyamattot futtat harminc ügyfélnek, minden ügyfélnek saját hitelesítő-készletet ad, és a munkafolyamat a készletre hivatkozik, nem a titokra. Egy kulcs cseréje egyetlen szerkesztés egyetlen helyen — ez az egyik fő ok, amiért az ügynökségek idejönnek.
Amit érdemes tudni a korlátokról: egy teljesen felület nélküli rendszer — API nélkül, webhook nélkül, fájlmegosztás nélkül, semmi, csak egy ember kattintgat böngészőben — nem automatizálható sem ezzel, sem mással, ami becsületes. Nincs itt fejnélküli böngésző, amely felhasználónak adja ki magát, mert az első alkalommal elromlik, amikor a másik fél áthelyez egy gombot, és csendben romlik el.