Povezovanje česar koli

HTTP noter, HTTP ven, neprijetni deli opravljeni

Vsako orodje za avtomatizacijo oglašuje število integracij. Število je vedno veliko in vedno napačno vprašanje, ker je sistem, ki ga dejansko potrebujete, tisti, ki ga je leta 2014 zgradil nekdo v hiši, ki je odšel. Pomembno je, kako dobro orodje govori protokol, ki leži pod vsemi njimi.

Pripravljene povezave

Aplikacije, na katerih teče večina podjetij, imajo pripravljene korake: trgovine in tržnice, računovodstvo in izdajanje računov, preglednice in zbirke podatkov, koledarji in pošta, shramba in sporočanje, CRM-ji in pomoč uporabnikom, ponudniki plačil in prevozniki. Račun enkrat overite in polja so poimenovana v jeziku, ki ga uporablja aplikacija, ne v jeziku njenega JSON-a.

Kjer ima aplikacija posebnost poljskega trga — sistem izdajanja računov, ki mora biti pripravljen na KSeF, prevoznik, čigar nalepke so nacionalni standard — pripravljeni korak to ve, ker družina prodaja na ta trg in se je morala naučiti.

In potem splošni primer

Vse ostalo je korak HTTP, korak HTTP pa tukaj ni tolažilna nagrada. Je ista mehanika, na kateri so zgrajene pripravljene povezave, z isto obravnavo delov, ki jih je težko napisati sami.

Težavni deli

Obravnavani, da jih ne pišete znova

Preverjanje pristnosti

Ključi API, žetoni bearer, osnovna overitev, OAuth 2 z osvežitvijo, podpisovanje zahtev HMAC, vzajemni TLS. Poverilnica se shrani enkrat, sklicuje po imenu in se nikoli ne izpiše v dnevnik ali zapis zagona.

Paginacija

Kurzorji, številke strani, zamiki, glave Link in API, ki konec signalizira z vračanjem prazne tabele. Recite, katera oblika je, in korak prehodi celoten nabor.

Omejitve hitrosti

Zgornja meja na povezavo, upoštevana v vseh delovnih tokovih, ki jo uporabljajo. Ko ponudnik odgovori s 429 in Retry-After, korak počaka toliko časa, namesto da bi neprestano udarjal.

Ponovni poskusi in zamik

Začasne napake se ponovijo z naraščajočim zamikom in zgornjo mejo. Korak je čista funkcija svojih vhodov, zato ponovni poskus ponovno izvede korak, ne celotnega zagona.

Nerodni podatkovni paketi

JSON, kodiranje obrazcev, XML, navadno besedilo, večdelne nalaganja. Odgovori so razčlenjeni v polja, do katerih lahko dostopate po imenu, tudi do tistih, ugnezdenih štiri ravni globoko.

Časovne omejitve

Omejitev na korak, tako da ena počasna odvisnost ne more zadržati delavca, medtem ko se vse za njim vrsti. Kaj se zgodi, ko je omejitev dosežena, je vaša odločitev, za vsak korak posebej.

Če govori HTTP, se je pogovor že začel.

Dohodni spletni kljuki, vzeti resno

Vsak delovni tok ima lahko URL, ki ga zažene. Ta URL preverja podpise — HMAC v oblikah, ki jih uporabljajo pogosti ponudniki, in deljeni skrivni ključ, kjer je to vse, kar pošiljatelj zmore. Nepodpisan zahtevek k delovnemu toku, ki pričakuje podpis, je zavrnjen in zabeležen, ne pa tiho obdelan.

Odstranjevanje podvojenosti temelji na lastnem identifikatorju podatkovnega paketa, tako da pošiljatelj, ki ponovi pošiljanje, ker ni pravočasno videl vašega 200, dobi en zagon namesto treh. Deformirani paketi so shranjeni, skupaj z razlogom za zavrnitev, ker je najpogostejši vzrok skrivnostne vrzeli v avtomatizaciji pošiljatelj, ki si je premislil glede polja.

Sistemi, ki govorijo samo CSV

Obstajajo. Datoteka se ob štirih zjutraj pojavi na strežniku SFTP, prispe kot priloga ali pa je odložena v deljeno mapo. Delovni tok jo lahko opazuje, prebere in vsako vrstico obravnava kot zapis — vključno z datoteko z oznako vrstnega reda bajtov, podpičji kot ločili in glavo v poljščini, ker tako dejansko izgleda izvoz.

Deluje tudi v obratni smeri: delovni tok lahko sestavi datoteko in jo odloži tam, kjer jo drugi sistem pričakuje najti — kar je pogosto edini vmesnik, ki ga ima programska oprema iz leta 2006.

Nočni vir od dobaviteljaSFTP → HTTP

⚡Sprožilec04:02Nova datoteka na SFTP dobavitelja: stock-2026-09-09.csv.
2RazčleniPodpičja, oznaka vrstnega reda bajtov, poljske glave. 4 118 vrstic.
3NormalizirajKode valut preverjene z referenčnimi podatki; dve zavrnjeni kot neveljavni.
4Potisnite2.9 sHTTP PATCH v serijah po 200, omejitev hitrosti upoštevana.
!IzjemeDve vrstici zabeleženi za osebo, s številko vrstice in razlogom. Preostalih 4 116 je uspešno prešlo.

Koraki, ki so klicali model: 0Stroški tega zagona: nič

Kje živijo poverilnice

Šifrirane, navedene po imenu, obsegane na delovni prostor, ki jih lasti, in nikoli izrisane v dnevnik zagona, sporočilo o napaki ali pogovor s podporo. Zapis zagona pokaže, da se je korak overil kot supplier-sftp; ne pokaže pa, kaj je supplier-sftp.

Agencija, ki vodi en delovni tok za trideset strank, daje vsaki stranki svoj nabor poverilnic, delovni tok pa se sklicuje na nabor in ne na skrivnost. Zamenjava ključa je ena sprememba na enem mestu — kar je večji del razloga, da agencije pridejo sem.

Omejitev, ki jo je vredno poznati: sistema brez vsakršnega vmesnika — brez API-ja, brez spletnega kljuka, brez oddaje datotek, ničesar razen osebe, ki kliklja v brskalniku — ta ali karkoli drugega poštenega ne more avtomatizirati. Tu ni brezglavega brskalnika, ki bi se pretvarjal, da je uporabnik, ker ta pokvari ob prvem premiku gumba na drugi strani — in pokvari se tiho.