Jungimas bet ko

HTTP į vidų, HTTP į išorę, nepatogios dalys sutvarkytos

Kiekvienas automatizavimo įrankis reklamuoja integracijų skaičių. Tas skaičius visada didelis ir visada kelia netinkamą klausimą, nes sistema, kurios iš tiesų jums reikia, yra ta, kuri 2014 m. viduje pasidarė kažkas, kuris jau išėjo. Svarbu, kaip gerai įrankis moka kalbą, kuria kalba visų jų pagrindu esantis protokolas.

Paruoštieji ryšiai

Programos, kuriomis remiasi dauguma verslų, turi paruoštų žingsnių: parduotuvės ir rinkos, apskaita ir sąskaitos, skaičiuoklės ir duomenų bazės, kalendoriai ir paštas, saugojimas ir susirašinėjimas, CRM ir pagalbos tarnybos, mokėjimų teikėjai ir vežėjai. Paskyrą autorizuojate kartą, o laukai pavadinti ta kalba, kuria kalba pati programa, ne jos JSON kalba.

Kur programoje yra Lenkijos rinkos ypatumas — sąskaitų išrašymo sistema, kuri turi būti pasirengusi KSeF, vežėjas, kurio etiketės yra nacionalinis standartas — paruoštasis žingsnis tai žino, nes šeima parduoda į tą rinką ir turėjo to išmokti.

O tada — bendrasis atvejis

Viskas kita yra HTTP žingsnis, ir HTTP žingsnis čia nėra paguodos prizas. Tai ta pati mašinerija, kuria grindžiami paruoštieji ryšiai, su tuo pačiu tvarkymu tų dalių, kurias pačiam rašyti nuobodu.

Nuobodžiosios dalys

Sutvarkytos, kad jų nerašytumėte dar kartą

Autentifikavimas

API raktai, bearer tokenai, basic auth, OAuth 2 su atnaujinimu, HMAC užklausų pasirašymas, abipusis TLS. Prieigos duomenys saugomi kartą, nurodomi pavadinimu ir niekada neišspausdinami į žurnalą ar vykdymo įrašą.

Puslapiavimas

Žymekliai, puslapių numeriai, poslinkiai, Link antraštės ir API, kuris pabaigą signalizuoja grąžindamas tuščią masyvą. Nurodykite, kokios tai formos, ir žingsnis pereis visą rinkinį.

Užklausų ribai

Ribas vienam ryšiui, laikomasi visose darbo eigose, kurios juo naudojasi. Kai teikėjas atsako 429 su Retry-After, žingsnis palaukia tiek, o ne spaudžia toliau.

Pakartojimai ir laukimas

Laikinosios klaidos kartojamos su didėjančia pauze ir riba. Žingsnis yra gryna savo įvesties funkcija, todėl pakartojimas iš naujo vykdo žingsnį, o ne visą vykdymą.

Nepatogūs duomenų formatai

JSON, formų kodavimas, XML, paprastas tekstas, multipart įkėlimai. Atsakymai išanalizuojami į laukus, kuriuos galite nurodyti pagal pavadinimą, įskaitant tuos, kurie yra keturiais lygiais giliau.

Laiko limitai

Limitas kiekvienam žingsniui, kad viena lėta priklausomybė negalėtų užimti darbininko, kol viskas už jos eilėje. Kas atsitiks pasiekus limitą — Jūsų sprendimas, kiekvienam žingsniui atskirai.

Jei jis kalba HTTP, pokalbis jau prasidėjo.

Įeinantys webhook'ai, verti rimtai

Kiekviena darbo eiga gali turėti URL, kuris ją paleidžia. Tas URL tikrina parašus — HMAC formomis, kurias naudoja dažniausi teikėjai, ir bendru paslapčiu raktu ten, kur daugiau siuntėjas nemoka. Nepasirašyta užklausa į darbo eigą, kuri tikisi parašo, atmetama ir užfiksuojama, o ne tyliai apdorojama.

Deduplikacija pagrįsta pačio duomenų paketo identifikatoriumi, todėl siuntėjas, kuris pakartoja, nes laiku nepastebėjo Jūsų 200, gauna vieną vykdymą, o ne tris. Neformalūs duomenų paketai išsaugomi su priežastimi, kodėl jie atmesti, nes dažniausia paslaptingos spragos automatizacijoje priežastis — siuntėjas, kuris persigalvojo dėl lauko.

Sistemos, kurios kalba tik CSV

Jos egzistuoja. Failas ryte keturiose atsiranda SFTP serveryje, arba atkeliauja kaip priedas, arba patenka į bendrą aplanką. Darbo eiga gali jo laukti, jį perskaityti ir kiekvieną eilutę traktuoti kaip įrašą — įskaitant failą su baitų eiliškumo ženklu, kabliataškiais skyrikliais ir antrašte lenkų kalba, nes būtent taip atrodo tas eksportas.

Veikia ir atvirkščiai: darbo eiga gali sudaryti failą ir padėti jį ten, kur kita sistema tikisi jį rasti — dažnai tai vienintelė 2006 metų programinės įrangos sąsaja.

Naktinis tiekėjo duomenų srautasSFTP → HTTP

⚡Aktyviklis04:02Naujas failas tiekėjo SFTP serveryje: stock-2026-09-09.csv.
2AnalizėKabliataškiai, baitų eiliškumo ženklas, lenkiškos antraštės. 4 118 eilučių.
3NormalizavimasValiutų kodai patikrinti pagal atskaitinius duomenis; du atmesti kaip netinkami.
4Įkelti2.9 sHTTP PATCH po 200 vienetais, laikomasi užklausų ribų.
!IšimtysDvi eilutės perduotos žmogui, su eilutės numeriu ir priežastimi. Kitos 4 116 praėjo.

Žingsniai, kurie kreipėsi į modelį: 0Šio vykdymo kaina: nieko

Kur gyvena prisijungimo duomenys

Šifruoti, nurodomi pagal pavadinimą, apibrėžti darbo sritimi, kuriai priklauso, ir niekada nerodomi vykdymo žurnale, klaidos pranešime ar palaikymo pokalbyje. Vykdymo įrašas rodo, kad žingsnis prisijungė kaip supplier-sftp; jis nerodo, kas yra supplier-sftp.

Agentūra, vykdanti vieną darbo eigą trisdešimt klientų, kiekvienam klientui suteikia savo prisijungimo duomenų rinkinį, o darbo eiga nurodo rinkinį, o ne paslaptį. Rakto atnaujinimas — vienas pakeitimas vienoje vietoje — tai daugiausia priežastis, kodėl agentūros čia atkeliauja.

Verta žinoti riba: sistemos, kurios iš viso neturi sąsajos — jokio API, jokio webhook'o, jokio failų perdavimo, nieko, tik žmogus, spaudžiantis naršyklėje, — negalima automatizuoti nei čia, nei jokiais kitais sąžiningais būdais. Čia nėra naršyklės be sąsajos, apsimetančios vartotoju, nes ji sulūžtą pirmą kartą, kai kita pusė perkels mygtuką, ir sulūžtą tyliai.