Kā savienot jebko
HTTP iekšā, HTTP ārā, nepatīkamās daļas nokārtotas
Katrs automatizācijas rīks reklamē integrāciju skaitu. Skaitlis vienmēr ir liels un vienmēr ir nepareizs jautājums, jo sistēma, kas jums patiesībā vajadzīga, ir tā, ko 2014. gadā uzbūvēja kāds pats uzņēmumā un kas aizgāja. Svarīgi ir tas, cik labi rīks runā ar protokolu, kas atrodas zem visiem tiem.
Gatavie savienojumi
Lietotnēm, uz kurām darbojas lielākā daļa uzņēmumu, ir sagatavoti soļi: veikali un tirgus vietas, grāmatvedība un rēķini, izklājlapas un datubāzes, kalendāri un pasts, krātuve un ziņojumapmaiņa, CRM un palīdzības dienesti, maksājumu sniedzēji un piegādes pārvadātāji. Jūs vienreiz autorizējat kontu, un lauki ir nosaukti lietotnes valodā, nevis tās JSON valodā.
Ja lietotnei ir kāda poļu tirgus īpatnība — rēķinu sistēma, kas jābūt gatavai KSeF, pārvadātājs, kura etiķetes ir nacionāls standarts —, sagatavotais solis to zina, jo saime pārdod šajā tirgū un nācās to iemācīties.
Un tad vispārīgais gadījums
Viss pārējais ir HTTP solis, un HTTP solis šeit nav mierinājuma balva. Tas ir tā pati mehānisms, uz kura būvēti gatavie savienojumi, ar tādu pašu apstrādi tām daļām, kuras ir apnicīgi rakstīt pašam.
Apnicīgās daļas
Nokārtotas, lai jums tās nav jāraksta vēlreiz
Autentifikācija
API atslēgas, bearer tokeni, basic auth, OAuth 2 ar atjaunošanu, HMAC pieprasījumu parakstīšana, savstarpējais TLS. Pieteikumdati tiek saglabāti vienreiz, atsaukti pēc nosaukuma un nekad neizdrukāti žurnālā vai izpildes ierakstā.
Lapošana
Kursori, lappušu numuri, nobīdes, Link galvenes un API, kas beigas signalizē ar tukšu masīvu. Pasakiet, kāda ir forma, un solis iziet visu kopumu.
Pieprasījumu ierobežojumi
Robeža vienam savienojumam, kas tiek ievērota katrā darbplūsmā, kas to izmanto. Kad pakalpojumu sniedzējs atbild ar 429 un Retry-After, solis gaida tik ilgi, nevis turpina bombardēt.
Atkārtoti mēģinājumi un aizkave
Ātri pārejoši kļūmju gadījumi tiek atkārtoti ar pieaugošu pauzi un ierobežojumu. Solis ir tīra funkcija no saviem ievaddatiem, tāpēc atkārtojums atkārto soli, nevis visu izpildi.
Sarežģīti datu formāti
JSON, formu kodējums, XML, vienkāršs teksts, multipart augšupielādes. Atbildes tiek parsētas laukos, uz kuriem varat atsaukties pēc nosaukuma, tostarp tos, kas ligzdoti četros līmeņos dziļāk.
Noildves
Ierobežojums katram solim, lai viena lēna atkarība neaizņemtu izpildītāju, kamēr viss pārējais rindā gaida. Kas notiek, kad ierobežojums tiek sasniegts, ir Jūsu lēmums, katram solim atsevišķi.
Ja tas runā HTTP, saruna jau ir sākusies.
Ienākošie tīmekļa āķi — uztverti nopietni
Katrai darbplūsmai var būt URL, kas to uzsāk. Šis URL pārbauda parakstus — HMAC formātos, ko izmanto izplatītākie pakalpojumu sniedzēji, un koplietošanas noslēpumu tur, kur sūtītājs vairāk nespēj. Nepārparakstīts pieprasījums darbplūsmai, kas sagaida parakstu, tiek noraidīts un reģistrēts, nevis klusi apstrādāts.
Deduplikācija balstās uz paša datu ieraksta identifikatoru, tāpēc sūtītājs, kas atkārto, jo laikus neredzēja Jūsu 200, iegūst vienu izpildi, nevis trīs. Kļūdainie datu ieraksti tiek saglabāti kopā ar noraidīšanas iemeslu, jo visbiežākais noslēpumainas nepilnības cēlonis automatizācijā ir sūtītājs, kas mainīja viedokli par kādu lauku.
Sistēmas, kas runā tikai CSV
Tādas pastāv. Fails parādās SFTP serverī četros no rīta, ierodas kā pielikums vai tiek iemests koplietošanas mapē. Darbplūsma var to uzraudzīt, nolasīt un katru rindu apstrādāt kā ierakstu — tostarp failu ar baitu secības atzīmi, semikolu atdalītājiem un galvenes rindu poļu valodā, jo tieši tā izskatās reālais eksports.
Arī pretējais virziens darbojas: darbplūsma var salikt failu un novietot to vietā, kur otra sistēma to sagaida — bieži vien tas ir vienīgais 2006. gada programmatūras saskarnes veids.
- ⚡TrigerisJauns fails piegādātāja SFTP serverī:
stock-2026-09-09.csv. - 2ParsēšanaSemikoli, baitu secības atzīme, poļu galvenes. 4 118 rindas.
- 3NormalizācijaValūtu kodi pārbaudīti pret atsauces datiem; divi noraidīti kā nederīgi.
- 4AugšupielādētHTTP
PATCHpa 200 vienā porcijā, ievērojot pieprasījumu ierobežojumu. - !IzņēmumiDivas rindas iesniegtas cilvēkam, ar rindas numuru un iemeslu. Pārējās 4 116 izgāja cauri.
Soļi, kas izsauca modeli: 0Šīs izpildes izmaksas: nekādas
Kur glabājas pieteikšanās dati
Šifrēti, atsaucami pēc nosaukuma, ierobežoti ar tādu darbvietu, kam tie pieder, un nekad neattēloti izpildes žurnālā, kļūdas ziņojumā vai atbalsta sarunā. Izpildes ieraksts rāda, ka solis autentificējās kā supplier-sftp; tas nerāda, kas supplier-sftp ir.
Aģentūra, kas vada vienu darbplūsmu trīsdesmit klientiem, katram klientam piešķir savu pieteikšanās datu kopu, un darbplūsma atsaucas uz kopu, nevis uz noslēpumu. Atslēgas nomaiņa ir viena labojums vienā vietā — un tas ir galvenais iemesls, kāpēc aģentūras šeit ierodas.
Ierobežojums, ko vērts zināt: sistēmu bez jebkādas saskarnes — bez API, bez tīmekļa āķa, bez failu nodošanas, nekas, izņemot cilvēku, kas klikšķina pārlūkā, — nevar automatizēt ne šī sistēma, ne nekas cits godīgs. Šeit nav bezgalvas pārlūka, kas izliekas par lietotāju, jo tas sabojājas, tiklīdz otrā puse pārvieto pogu, un sabojājas klusi.