Povezivanje bilo čega

HTTP ulazi, HTTP izlazi, nezgodni dijelovi obavljeni

Svaki alat za automatizaciju reklamira broj integracija. Broj je uvijek velik i uvijek je pogrešno pitanje, jer je sistem koji Vi stvarno trebate onaj izgrađen interno 2014. od strane nekoga ko je otišao. Važno je koliko dobro alat govori protokol koji leži ispod svih njih.

Gotove veze

Aplikacije na kojima većina preduzeća radi imaju pripremljene korake: prodavnice i tržišta, računovodstvo i fakturisanje, tabele i baze podataka, kalendari i pošta, skladištenje i razmjena poruka, CRM-i i helpdesks, pružatelji plaćanja i dostavljaci. Jednom autorizujete račun i polja su imenovana jezikom koji aplikacija koristi, a ne jezikom njenog JSON-a.

Kada aplikacija ima posebnost poljskog tržišta — sistem fakturisanja koji mora biti spreman za KSeF, dostavljač čije su etikete nacionalni standard — pripremljeni korak to zna, jer porodica prodaje na to tržište i morala je naučiti.

A onda opšti slučaj

Sve ostalo je HTTP korak, i HTTP korak ovdje nije utješna nagrada. To je ista mehanika na kojoj su izgrađene gotove veze, s istim rukovanjem dijelovima koji su zamorni za pisati sami.

Zamorni dijelovi

Obavljeni, da ih Vi ne pišete ponovo

Provjera autentičnosti

API ključevi, bearer tokeni, basic auth, OAuth 2 s osvježavanjem, HMAC potpisivanje zahtjeva, obostrani TLS. Vjerodajnica se pohrani jednom, referencira po imenu i nikad se ne ispisuje u log ili zapis izvođenja.

Paginacija

Kursori, brojevi stranica, ofseti, Link zaglavlja i API koji signalizira kraj vraćanjem praznog niza. Recite koji je oblik u pitanju i korak će proći kroz cijeli skup.

Ograničenja brzine

Gornja granica po vezi, poštovana u svakom toku rada koji je koristi. Kada pružalac odgovori s 429 i Retry-After, korak čeka toliko dugo umjesto da napada dalje.

Ponovni pokušaji i odgode

Privremeni kvarovi se ponavljaju s rastućim razmakom i gornjom granicom. Korak je čista funkcija svojih ulaza, pa ponovni pokušaj ponovo pokreće korak, a ne cijelo izvršavanje.

Neugodni podaci

JSON, kodiranje obrazaca, XML, običan tekst, multipart otpremanja. Odgovori se raščlanjuju u polja kojima možete pristupiti po imenu, uključujući i ona ugniježđena četiri nivoa duboko.

Vremenska ograničenja

Ograničenje po koraku, tako da jedan spor zavisni sistem ne može zadržati radnika dok se sve iza njega čeka. Šta se dešava kada se granica dostigne, odlučujete Vi, po koraku.

Ako govori HTTP, razgovor je već počeo.

Dolazni webhooks, shvaćeni ozbiljno

Svaki tok rada može imati URL koji ga pokreće. Taj URL provjerava potpise — HMAC u oblicima koje koriste uobičajeni pružaoci, i dijeljenu tajnu tamo gdje je to sve što pošiljalac može. Nepotpisani zahtjev ka toku rada koji očekuje potpis se odbija i bilježi, a ne tiho obrađuje.

Deduplikacija se vrši po sopstvenom identifikatoru podataka, tako da pošiljalac koji ponavlja jer nije na vrijeme vidio Vaš 200 dobije jedno izvršavanje umjesto tri. Neispravni podaci se čuvaju, s razlogom odbijanja, jer je najčešći uzrok misterioznog nedostatka u automatizaciji pošiljalac koji je promijenio mišljenje o nekom polju.

Sistemi koji govore samo CSV

Oni postoje. Datoteka se pojavi na SFTP serveru u četiri ujutro, ili stigne kao prilog, ili se spusti u dijeljenu fasciklu. Tok rada može je pratiti, pročitati je i tretirati svaki red kao zapis — uključujući i datoteku s bajt-redoslijednom oznakom, tačka-zarez razdvojnicima i zaglavljem na poljskom, jer tako zaista izgleda taj izvoz.

I obrnuti smjer radi: tok rada može sastaviti datoteku i smjestiti je tamo gdje je drugi sistem očekuje, što je često jedini interfejs koji softver iz 2006. godine ima.

Noćni dovod podataka od dobavljačaSFTP → HTTP

⚡Okidač04:02Nova datoteka na SFTP-u dobavljača: stock-2026-09-09.csv.
2RaščlanjivanjeTačka-zarez razdvojnici, bajt-redoslijedna oznaka, poljska zaglavlja. 4 118 redova.
3NormalizacijaKodovi valuta provjereni prema referentnim podacima; dva odbijena kao nevažeća.
4Otpremite2.9 sHTTP PATCH u serijama od 200, s poštovanjem ograničenja brzine.
!IzuzeciDva reda upućena osobi, s brojem reda i razlogom. Ostalih 4 116 prošlo je kroz.

Koraci koji su pozvali model: 0Trošak ovog izvršavanja: ništa

Gdje se čuvaju akreditivi

Šifrovani, referencirani po imenu, ograničeni na radni prostor kojem pripadaju, i nikada prikazani u zapisniku izvršavanja, poruci o grešci ili razgovoru s podrškom. Zapis izvršavanja pokazuje da se korak autentifikovao kao supplier-sftp; ne pokazuje što supplier-sftp jest.

Agencija koja vodi jedan tok rada za trideset klijenata daje svakom klijentu sopstveni set akreditiva, a tok rada se odnosi na set, a ne na tajnu. Rotacija ključa je jedna izmjena na jednom mjestu — što je glavni razlog zašto agencije dolaze ovamo.

Ograničenje koje vrijedi znati: sistem bez ikakvog interfejsa — bez API-ja, bez webhooka, bez ispuštanja datoteka, ništa osim osobe koja klikće u pregledniku — ne može se automatizirati ni ovim ni ičim drugim poštenim. Ovdje nema bezglavog preglednika koji se pretvara da je korisnik, jer to puca prvi put kada druga strana pomjeri dugme, i puca tiho.