Enigiets verbind
HTTP in, HTTP uit, lastige dele hanteer
Elke outomatiseringgereedskap adverteer 'n aantal integrasies. Die getal is altyd groot en dit is altyd die verkeerde vraag, want die stelsel wat jy regtig nodig het, is die een wat in 2014 in-huis gebou is deur iemand wat weg is. Wat saakmaak, is hoe goed die gereedskap die protokol onder almal praat.
Die voorafgemaakte verbindings
Die toepassings waarop die meeste besighede loop, het voorbereide stappe: winkels en markplekke, rekeningkunde en fakture, sigblaaie en databasisse, kalenders en pos, berging en boodskapgewing, KVM's en hulpdesks, betaalverskaffers en verskeppers. Jy magtig die rekening een keer en die velde is genoem in die taal wat die toepassing gebruik, nie in die taal van sy JSON nie.
Waar 'n toepassing 'n Poolse mark-eienaardigheid het — 'n faktureerstelsel wat KSeF-gereed moet wees, 'n verskepper wie se etikette 'n nasionale standaard is — weet die voorbereide stap daarvan, want die gesin verkoop in daardie mark en moes dit leer.
En dan die algemene geval
Alles anders is 'n HTTP-stap, en 'n HTTP-stap hier is nie 'n troosprys nie. Dit is dieselfde masjinerie waarop die voorafgemaakte verbindings gebou is, met dieselfde hantering van die dele wat lastig is om self te skryf.
Die lastige dele
Hanteer, sodat jy dit nie weer skryf nie
Stawing
API-sleutels, draertokens, basiese outentisering, OAuth 2 met verfrissing, HMAC-versoekondertekening, onderlinge TLS. 'n Geldeenheid word een keer gestoor, by naam verwys, en nooit in 'n log of 'n lopierekord gedruk nie.
Paginering
Wysers, bladsynommers, verskuiwings, Link-koppe, en die API wat die einde aandui deur 'n leë array terug te gee. Sê watter vorm dit is en die stap loop die hele stel.
Koerslimiete
'n Plafon per verbinding, gerespekteer oor elke werkstroom wat dit gebruik. Wanneer 'n verskaffer met 429 en 'n Retry-After antwoord, wag die stap so lank in plaas daarvan om aan te hamer.
Herpogings en terugkeer-afwyking
Oorgangsfoute word herprobeer met 'n groeiende tussenpose en 'n plafon. 'n Stap is 'n pure funksie van sy insette, dus 'n herpoging herloop die stap, nie die hele lopie nie.
Onhandige lading
JSON, vorm-enkodering, XML, plat teks, multipart-oplaaie. Antwoorde word gepars in velde wat jy by naam kan verwys, ook dié wat vier vlakke diep genestel is.
Tydlimiete
'n Limiet per stap, sodat een stadige afhanklikheid nie 'n werker kan vashou terwyl alles agter dit in die tou staan nie. Wat gebeur wanneer die limiet getref word, is jou besluit, per stap.
As dit HTTP praat, het die gesprek al begin.
Inkomende webhooks, ernstig opgeneem
Elke werkstroom kan 'n URL hê wat dit begin. Daardie URL verifieer handtekeninge — HMAC in die vorms wat die gewone verskaffers gebruik, en 'n gedeelde geheimsleutel waar dit alles is wat die sender kan regkry. 'n Ongetekende versoek aan 'n werkstroom wat 'n handtekening verwag, word verwerp en aangeteken, nie stilweg verwerk nie.
Ontdubbeling geskied op die lading se eie identifiseerder, sodat 'n sender wat herprobeer omdat dit jou 200 nie betyds gesien het nie, een lopie kry eerder as drie. Misvormde ladings word gehou, met die rede waarom hulle verwerp is, want die gewoonste oorsaak van 'n raaiselagtige gaping in 'n outomatisering is 'n sender wat van gedagte verander het oor 'n veld.
Die stelsels wat slegs CSV praat
Hulle bestaan. 'n Lêer verskyn om vieruur die oggend op 'n SFTP-bediener, of kom as 'n aanhangsel aan, of word in 'n gedeelde vouer neergesit. 'n Werkstroom kan daarvoor wag, dit lees, en elke ry as 'n rekord behandel — ook die lêer met 'n byte-volgorde-merker, kommapunte as skeiers en 'n opskrifry in Pools, want so lyk die uitvoer werklik.
Die ander kant toe werk ook: 'n werkstroom kan 'n lêer saamstel en dit neersit waar die ander stelsel verwag om dit te vind, wat dikwels die enigste koppelvlak is wat 'n stuk sagteware uit 2006 het.
- ⚡SnellerNuwe lêer op die verskaffer se SFTP:
stock-2026-09-09.csv. - 2ParsKommapunte, byte-volgorde-merker, Poolse opskrifte. 4 118 rye.
- 3NormaliseerGeldeenheidskodes teen verwysingsdata gekontroleer; twee as ongeldig verwerp.
- 4DrukHTTP
PATCHin bondels van 200, koerslimiet gerespekteer. - !UitsonderingsTwee rye vir 'n persoon gelê, met die rynommer en die rede. Die ander 4 116 het deurgekom.
Stappe wat 'n model geroep het: 0Koste van hierdie lopie: niks
Waar geloofsbriewe woon
Geënkripteer, by naam verwys, beperk tot die werkspasie wat hulle besit, en nooit weergegee in 'n lopielog, 'n foutboodskap of 'n ondersteuningsgesprek nie. 'n Lopierekord wys dat 'n stap as supplier-sftp geïdentifiseer het; dit wys nie wat supplier-sftp is nie.
'n Agentskap wat een werkstroom vir dertig kliënte laat loop, gee elke kliënt sy eie stel geloofsbriewe, en die werkstroom verwys na die stel eerder as die geheimsleutel. Om 'n sleutel te roteer is een wysiging op een plek — wat meestal die rede is waarom agentskappe hierheen kom.
Die limiet wat die moeite werd is om te ken: 'n stelsel sonder enige koppelvlak — geen API, geen webhook, geen lêerafgooi, niks behalwe 'n persoon wat in 'n blaaier klik nie — kan nie deur hierdie of deur enigiets anders eerliks geoutomatiseer word nie. Daar is geen koplose blaaier hier wat voorgee om 'n gebruiker te wees nie, want dit breek die eerste keer wanneer die ander kant 'n knoppie skuif, en dit breek stilweg.