Mille iganese ühendamine

HTTP sisse, HTTP välja, tüütud osad käideldud

Iga automatiseerimistööriist reklaamib integratsioonide arvu. Arv on alati suur ja alati vale küsimus, sest süsteem, mida sa tegelikult vajad, on see, mis ehitati siseruumides 2014. aastal kellegi poolt, kes on läinud. Oluline on, kui hästi tööriist räägib nende kõigi all olevat protokolli.

Valmis ühendused

Rakendustel, millel enamik ettevõtteid töötab, on valmis sammud: poed ja turuplatsid, raamatupidamine ja arveldamine, tabelid ja andmebaasid, kalendrid ja post, salvestusruum ja sõnumid, CRM-id ja abikeskused, makseteenuse pakkujad ja veofirmad. Autoriseerid konto ühe korra ja väljad on nimetatud rakenduse enda keeles, mitte selle JSON-i keeles.

Kui mõnel rakendusel on Poola turu eripära — arveldussüsteem, mis peab olema KSeF-iga ühilduv, veofirma, mille sildid on riiklik standard — teab valmis samm sellest, sest perekond müüb sellesse turgu ja pidi seda õppima.

Ja siis üldine juht

Kõik muu on HTTP-samm, ja HTTP-samm siin ei ole lohutusauhind. See on sama masinavärk, millel valmis ühendused põhinevad, sama käsitlusega osadele, mis on ise kirjutades tüütud.

Tüütud osad

Käideldud, nii et sa ei pea neid uuesti kirjutama

Autentimine

API võtmed, bearer-tokenid, põhiautentimine, OAuth 2 koos uuendamisega, HMAC päringute allkirjastamine, vastastikune TLS. Mandaat salvestatakse ühe korra, viidatakse nimega ja seda ei prindita kunagi logisse ega käigu kirjesse.

Pagineerimine

Kursorid, leheküljenumbrid, nihe, Link päised ja API, mis annab lõpu märku tühja massiivi tagastamisega. Ütle, mis kuju see on, ja samm käib kogu hulga läbi.

Päringupiirangud

Lagi ühe ühenduse kohta, mida järgitakse igas töövoos, mis seda kasutab. Kui pakkuja vastab 429 koos Retry-After-iga, ootab samm täpselt nii kaua, selle asemel et pommitada.

Korduskatsed ja tagasipöördumine

Ajutisi tõrkeid korratakse kasvava vahega ja piiranguga. Samm on oma sisendite puhas funktsioon, seega korduskäivitus käivitab sammu, mitte kogu käigu.

Keerulised andmekogumid

JSON, vormi kodeering, XML, lihttekst, mitmeosalised üleslaadimised. Vastused parsitakse väljadeks, millele saad viidata nimega — sealhulgas need, mis on neli taset sügavamal pesas.

Ajalõpud

Piirang iga sammu kohta, nii et üks aeglane sõltuvus ei hoia tööjat kinni, samal ajal kui kõik järgnev järjekorras ootab. Mis piirangu saabumisel juhtub, oled sinu otsustada, iga sammu kohta eraldi.

Kui see räägib HTTP-d, on vestlus juba alanud.

Sisenevad veebihaagid, võetud tõsiselt

Igal töövool võib olla URL, mis selle käivitab. See URL kontrollib allkirju — HMAC-i kujul, mida tavalised pakkujad kasutavad, ja jagatud saladust seal, kus rohkem saatja suuta ei saa. Allkirjata päring töövoolule, mis allkirja ootab, lükatakse tagasi ja tähitakse üles, mitte ei töödeldud vaikselt.

Deduplikatsioon põhineb andmekogumi enda identifikaatoril, nii et saatja, kes proovib uuesti, sest ei näinud sinu 200-i õigel ajal, saab ühe käigu, mitte kolm. Vigased andmekogumid säilitatakse koos põhjusega, miks need tagasi lükati, sest kõige sagedasem põhjus müstilise augu jaoks automatiseerimises on saatja, kes muutis arvamust ühe välja kohta.

Süsteemid, mis räägivad ainult CSV-d

Nad eksisteerivad. Fail ilmub SFTP-serveril kell neli hommikul, või saabub manusena, või visatakse jagatud kausta. Töövool võib seda jälgida, lugeda ja käsitleda iga rida kirjena — sealhulgas fail, millel on baidijärje märk, semikoolonite eraldajad ja poolakeelne päiserida, sest just nii see eksport tegelikult välja näeb.

Teistpidi töötab ka: töövool võib koostada faili ja panna selle sinna, kus teine süsteem seda ootab, mis on sageli ainus liides, mida 2006. aasta tarkvaral on.

Öine tarnija voogSFTP → HTTP

⚡Käivitaja04:02Uus fail tarnija SFTP-l: stock-2026-09-09.csv.
2ParsiSemikoolonid, baidijärje märk, poolakeelsed päised. 4 118 rida.
3NormaliseeriValuutakoodid kontrollitud võrdlusandmete vastu; kaks lükati tagasi kui kehtetud.
4Lükka2.9 sHTTP PATCH 200 kaupa, päringupiirangust kinni peetud.
!ErandidKaks rida esitatud inimesele, koos rea numbriga ja põhjusega. Ülejäänud 4 116 läks läbi.

Sammud, mis kutsusid mudelit: 0Selle käigu hind: mitte midagi

Kus volikirjad elavad

Krüpteeritud, viidatud nimega, piiratud tööruumiga, mis neid omab, ja kunagi ei renderdata käigu logisse, veateatesse ega tugikeskuse vestlusesse. Käigu kirje näitab, et samm autentis kui supplier-sftp; see ei näita, mis supplier-sftp on.

Agentuur, kes käitab üht töövoolu kolmekümne kliendi jaoks, annab igale kliendile oma volikirjade komplekti, ja töövool viitab komplektile, mitte saladusele. Võtme vahetamine on üks muudatus ühes kohas — mis on suurem osa põhjusest, miks agentuurid siia tulevad.

Piirang, mida tasub teada: süsteemi, millel pole üldse mingit liidest — ei API-t, ei veebihaaki, ei faili langemist, mitte midagi muud kui inimene, kes klõpsab brauseris — ei saa automatiseerida ei see ega ükski teine aus vahend. Siin pole headless brauserit, mis teeskleb kasutajat, sest see puruneb esimesel korral, kui teine pool nupu ümber tõstab, ja puruneb vaikselt.