Kople til noko

HTTP inn, HTTP ut, dei vanskelege delane handtert

Kvart automatiseringsverktøy reklamerer med eit tal integrasjonar. Talet er alltid stort, og det er alltid feil spørsmål, for systemet du faktisk treng er det som vart bygd internt i 2014 av nokon som har slutta. Det som betyr noko, er kor godt verktøyet talar protokollen under alle saman.

Dei ferdige koplingane

Applikasjonane dei fleste verksemader driv på har førebudd steg: butikkar og marknadsplasar, rekneskap og fakturering, rekneark og databasar, kalendrar og e-post, lagring og meldingar, CRM-ar og brukarstøtte, betalingsleverandørar og fraktløysingar. Du godkjenner kontoen éin gong, og felt har namna applikasjonen sjølv bruker, ikkje namna frå JSON-en dens.

Der ein programvare har ein særskildheit for det polske marknaden — eit faktureringssystem som må vere KSeF-klart, ein fraktføretar der etikettane er ein nasjonal standard — veit det førebudde steget om det, for familien sel til det marknaden og måtte lære det.

Og så det generelle tilfellet

Alt anna er eit HTTP-steg, og eit HTTP-steg her er ingen trøstepremie. Det er same maskineriet som dei ferdige koplingane er bygd på, med same handteringa av delane som er slitne å skrive sjølv.

Dei slitne delane

Handtert, slik at du ikkje skriv dei inn att

Autentisering

API-nøklar, bearer-token, basic auth, OAuth 2 med refresh, HMAC-signering av førespurnader, gjensidig TLS. Eit credentials blir lagra éin gong, referert til ved namn, og blir aldri skrivne ut i ein logg eller ein køyringslogg.

Paginering

Cursors, sidenummer, offsettar, Link-hovud, og API-et som signaliserer slutten ved å returnere ein tom tabell. Sei kva form det er, så går steget gjennom heile mengda.

Hastingsgrenser

Eit tak per tilkopling, som blir respektert på tvers av alle arbeidsflytar som brukar den. Når ein leverandør svarar 429 med ein Retry-After, ventar steget så lenge i staden for å hamre på.

Retries og backoff

Forbigåande feil blir prøvd på nytt med aukande mellomrom og eit tak. Eit steg er ein rein funksjon av inndataene sine, så eit nytt forsøk køyrer steget på nytt, ikkje heile køyringa.

Vanskelege nyttelastar

JSON, forms-koding, XML, rein tekst, multipart-opplastingar. Svar blir tolka inn i felt du kan referere til ved namn, også dei som ligg fire nivå ned.

Tidsavgrensingar

Eit tak per steg, slik at éi treg avhengigheit ikkje kan halda ein worker medan alt bak køen. Kva som skjer når taket er nådd, bestemmer du, per steg.

Snakkar det HTTP, er samtalen allereie i gang.

Innkommande webhooks, tatt på alvor

Kvar arbeidsflyt kan ha ein URL som startar han. Den URL-en stadfestar signaturar — HMAC i formene dei vanlege leverandørane brukar, og ein delt hemmelegheit der det er alt avsendaren klarer. Ein usignert førespurnad til ein arbeidsflyt som krev signatur blir avvist og loggført, ikkje stille handsama.

Deduplisering skjer på nyttelasta si eiga identifikator, så ein avsendar som prøver på nytt fordi han ikkje såg 200-en din i tide, får éi køyring i staden for tre. Feilforma nyttelastar blir tekne vare på, med grunnen til at dei blei avviste, fordi den vanlegaste årsaka til eit mystisk hull i ein automatisering er ein avsendar som ombestemte seg om eit felt.

Systema som berre snakkar CSV

Dei finst. Ei fil dukkar opp på ein SFTP-server klokka fire om natta, eller kjem som eit vedlegg, eller blir lagt i ei delt mappe. Ei arbeidsflyt kan passa på den, lesa han, og handsame kvar rad som ein post — også fila med byte-rekkefølgemerke, semikolon som skiljeteikn og topptekst på polsk, fordi det er slik eksporten faktisk ser ut.

Å gå den andre vegen fungerer også: ei arbeidsflyt kan setja saman ei fil og leggja henne der det andre systemet forventar å finna henne, noko som ofte er det einaste grensesnittet eit program frå 2006 har.

NattleverandørstraumSFTP → HTTP

⚡Utløysar04:02Ny fil på leverandøren sin SFTP: stock-2026-09-09.csv.
2TolkSemikolon, byte-rekkefølgemerke, polske topptekstar. 4 118 rader.
3NormaliserValutakodar kontrollerte mot referansedata; to avviste som ugyldige.
4Skyv2.9 sHTTP PATCH i bolkar på 200, rate limit respektert.
!UnntakTo rader lagt til framsida for ein person, med radnummer og grunnen. Dei andre 4 116 gjekk gjennom.

Steg som kalte ein modell: 0Kostnaden for denne køyringa: ingenting

Der credentials bur

Krypterte, refererte ved namn, avgrensa til arbeidsområdet som eigar dei, og aldri vist fram i ein køyringslogg, ei feilmelding eller ein støttesamtale. Ein køyringslogg viser at eit steg autentiserte seg som supplier-sftp; han viser ikkje kva supplier-sftp er.

Eit byrå som køyrer éi arbeidsflyt for tretti kundar gir kvar kunde sitt eige sett med credentials, og arbeidsflyten refererer til settet i staden for hemmelegheita. Å rotere ein nøkkel er éi endring på éi stad — det er det meste av grunnen til at byråer kjem hit.

Taket som er verdt å vita: eit system utan nokon grensesnitt i det heile — ingen API, ingen webhook, ingen fillevering, ingenting anna enn ein person som klikkar i ein nettlesar — kan ikkje automatiserast av dette eller av noko anna ærleg. Det finst ingen headless-nettlesar som later som han er ein brukar her, fordi den brot første gongen motparten flyttar ein knapp, og han brot stille.