Kas yra „webhook“, kaip jis veikia ir kam jis naudojamas?

Šiuolaikinės programos yra nuolat sujungtos : CRM, internetinės parduotuvės, mokėjimo vartai, rinkodaros įrankiai, pagalbos platformos... Visos jos turi bendrauti tarpusavyje, kad galėtų akimirksniu dalytis duomenimis. Jei kiekviena sistema turėtų nuolat klausti: „Ar yra kas nors naujo?“, rezultatas būtų lėtas, brangiai prižiūrimas ir labai neefektyvus tinklas.

Siekiant išvengti šio chaoso, yra paprastas, bet neįtikėtinai galingas mechanizmas: „webhooks“ – maži, automatiniai pranešimai, kuriuos viena programa siunčia kitai, kai įvyksta konkretus įvykis . Jie yra daugelio dabartinių integracijų pagrindas – nuo ​​internetinės parduotuvės atsargų atnaujinimo realiuoju laiku iki infrastruktūros kaip kodo darbo eigų ar „GitOps“ automatizavimo paleidimo sudėtingose ​​IT aplinkose.

Kas yra webhook ir kodėl jis tapo toks svarbus?

Trumpai tariant, „webhook“ – tai būdas vienai programai pranešti kitai, kad kažkas įvyko , automatiškai siunčiant duomenis į URL adresą, kai įvyksta konkretus įvykis. Užklausą pateikia ne kita programa, o sistema, kuri pati generuoja įvykį, ir „perduoda“ informaciją tinkamu momentu.

Kasdieniškai „webhook“ labiau primena „WhatsApp“ įspėjimą nei svetainės tikrinimą kas penkias minutes, ar nėra atnaujinimų . Siunčianti programa (pvz., jūsų el. prekybos platforma) siunčia HTTP užklausą konkrečiu adresu, perkeldama duomenis (dažniausiai JSON formatu), o gaunanti programa apdoroja šią informaciją ir atitinkamai veikia.

Tipiškas pavyzdys: klientas perka jūsų internetinėje parduotuvėje ir, atlikus mokėjimą, suveikia žiniatinklio kabliukas, kuris siunčia visus užsakymo duomenis į jūsų siuntimo sistemą arba ERP . Nereikia paleisti rankinių procesų, importuoti failų ar periodiškai atlikti užklausų: priimančioji sistema informuojama, kai tik patvirtinamas pardavimas.

Ši „įvykio, kuris paleidžia duomenis“, idėja daro žiniatinklio kabliukus idealius darbo eigų automatizavimui, sistemų sinchronizavimui ir reagavimui realiuoju laiku į tai, kas vyksta jūsų verslo ar techninėje infrastruktūroje.

Kaip „webhook“ veikia viduje

Vidinis žiniatinklio kabliuko veikimas yra paprastas, tačiau labai galingas . Visada yra du pagrindiniai veikėjai: programa, kuri išduoda žiniatinklio kablį, kai aptinka įvykį, ir programa, kuri jį gauna ir priima sprendimus remdamasi išsiųsta informacija.

Siunčiančiojoje pusėje konfigūruojate, kokio tipo įvykis suaktyvins žiniatinklio kablį ir kuriuo URL adresu bus siunčiami duomenys . Šis URL priklauso priimančiajai sistemai, kuri ruošiasi klausytis ir apdoroti gaunamas užklausas (paprastai per HTTP maršrutą, kuris priima POST užklausas su JSON duomenimis).

Kai sąlyga įvykdoma (pavyzdžiui, „sukurtas naujas kontaktas“, „mokėjimas priimtas“, „prenumerata atšaukta“ ), siunčianti programa sugeneruoja HTTP užklausą į „webhook“ URL. Šioje užklausoje pateikiama informacija apie įvykius: identifikatoriai, sumos, būsenos, vartotojo duomenys ir kt.

Priimančiojoje pusėje programa, kuri klausosi to URL, apdoroja naudingąją apkrovą ir vykdo apibrėžtus veiksmus : įrašo įrašymą į duomenų bazę, CRM atnaujinimą, kito automatizavimo srauto paleidimą, vidinio įspėjimo aktyvavimą, ERP sinchronizavimą... viską, kas yra prasminga verslui.

Techniškai didžioji dauguma žiniatinklio kabliukų naudoja HTTP ir paprastai veikia su POST užklausomis , nes tai palengvina duomenų siuntimą užklausos tekste. Dėl to jie suderinami su praktiškai bet kokia kalba ir kūrimo aplinka – nuo ​​PHP ar Node.js iki Python , Java ar tokių sistemų kaip Laravel, Django ar Spring.

Įvykiai, kurie gali suaktyvinti žiniatinklio kablį

Įvykiai, kurie suaktyvina žiniatinklio kablį, visiškai priklauso nuo siunčiančios programos ir verslo modelio. Bet koks net ir mažai reikšmingas dalykas gali tapti suaktyvinančiu veiksniu, jei įrankis tai palaiko.

Pavyzdžiui, mokėjimo šliuze labai dažnai pateikiami skirtingi įvykiai, skirti priimtiems mokėjimams, atmestiems mokėjimams arba grąžinimams . Kiekvienas iš jų gali siųsti skirtingą žiniatinklio kablį su atitinkama būsena, kad priimanti sistema galėtų atitinkamai veikti (patvirtinti užsakymą, pažymėti jį kaip nepavykusį, inicijuoti grąžinimą ir pan.).

CRM arba rinkodaros įrankyje žiniatinklio kabliai paprastai suaktyvinami, kai sukuriami, atnaujinami arba ištrinami kontaktai, įmonės, galimybės arba prenumeratos . Tai leidžia kitoms sistemoms (pvz., ERP arba išorinei el. pašto platformai) gauti naujausią informaciją.

Net ir labiau techniškai techniškai pagrįstoje aplinkoje „webhook“ galima suaktyvinti įkėlus kodą į „Git“ saugyklą, patvirtinus užklausą dėl išgavimo arba pakeitus infrastruktūros konfigūracijos failą . Iš ten CI/CD darbo eigos, automatiniai diegimai arba infrastruktūros kaip kodo užduotys yra sujungiamos.

Apibendrinant: bet koks svarbus įvykis programoje, apie kurį „verta pranešti“ kitai sistemai, yra geras kandidatas tapti „webhook“ įvykiu.

Skirtumai tarp žiniatinklio kabliukų ir tradicinių API

Nors kartais painiojami, žiniatinklio kabliai ir API nėra tas pats, nors jie vienas kitą papildo . Abu jie skirti programoms sujungti ir duomenims perkelti, tačiau tai daro skirtingais būdais.

Klasikinė API veikia „traukimo“ modeliu: jūsų programa pateikia užklausą kito įrankio API, kai jai reikia duomenų arba ji nori atlikti veiksmą . Tai reiškia, kad klientas turi žinoti, kada pateikti užklausą (pavyzdžiui, kas 5 minutes) ir aiškiai pateikti užklausą.

Naudojant „webhook“, procesas yra atvirkštinis: jums nebereikia nuolat teikti užklausų; vietoj to, sistema, kuri generuoja informaciją, ją siunčia, kai kas nors nutinka . Štai kodėl, kalbėdami apie „webhooks“, dažnai kalbame apie „atvirkštinę API“ arba „push API“.

Techniniu požiūriu: API puikiai tinka duomenims skaityti ar modifikuoti pagal poreikį , suteikiant didelę kontrolę, kas ir kada prašoma. Kita vertus, „webhooks“ idealiai tinka gauti realiuoju laiku pranešimus apie konkrečius pakeitimus , nereikalaujant nuolatinės apklausos ar išteklių eikvojimo nereikalingoms užklausoms.

Tipiškiausias derinys yra naudoti žiniatinklio kabliukus, kad sužinotumėte, jog kažkas įvyko, ir API, kad išplėstumėte šią informaciją arba atliktumėte veiksmus . Pavyzdžiui, gaunate žiniatinklio kabliuką su sukurtos išlaidos ID, o tada iškviečiate API, kad gautumėte visą papildomą informaciją apie tas išlaidas.

„Webhooks“, infrastruktūra kaip kodas (IaC) ir „GitOps“

Be verslo integracijų, žiniatinklio kabliai yra labai svarbūs infrastruktūros kaip kodo aplinkose ir „GitOps“ praktikoje . Jie jungia ne tik rinkodaros ir pardavimo programas, bet ir platformas, kurios valdo serverius, konteinerius ir debesijos išteklius.

Infrastruktūra kaip kodas (IaC) apima serverių, tinklų, saugyklų ir kitų infrastruktūros komponentų apibrėžimą ir valdymą naudojant konfigūracijos failus ir kodą , o ne rankiniu būdu naudojant ataskaitų suvestines ar grafinius vedlius. Tai leidžia valdyti pakeitimų versijas „Git“ saugyklose, automatizuoti diegimus ir kurti atkuriamas aplinkas.

Čia praverčia „GitOps“ – metodas, kuris naudoja „Git“ kaip vienintelį patikimą informacijos šaltinį infrastruktūros ir programų konfigūravimui . Pakeitimai įvedami per pakeitimus ir užklausas, o norimos būsenos variklis (pavyzdžiui, „Ansible“ tipo platforma arba „Kubernetes“ operatoriai) yra atsakingas už faktinės būsenos suderinimą su tuo, ką nurodo saugykla.

Kur tinka žiniatinklio kabliai? Jie veikia kaip pranešimų jungtis tarp „Git“ saugyklos ir norimos būsenos modulio . Kiekvieną kartą, kai atliekamas pakeitimas arba sujungiama šaka, „Git“ siunčia žiniatinklio kablį automatizavimo įrankiui, kuris interpretuoja pakeitimą ir pritaiko naują konfigūraciją infrastruktūrai.

Taigi, paprastas YAML failo ar veiksmų plano pakeitimas gali sukelti visą automatizavimo grandinę : serverio kūrimą, konteinerio diegimą , paslaugų atnaujinimus, atšaukimą, jei kas nors nepavyksta ir kt. „Webhook“ yra „trigeris“, kuris kodo pakeitimą paverčia konkrečiu veiksmu infrastruktūroje.

Įvykiais pagrįsta automatizacija ir trigerio kilmė

Aukščiau aprašytą metodą galima išplėsti bet kokio tipo įvykiais pagrįstai automatizacijai . Šaltinis nebūtinai turi būti „Git“ saugykla; tai taip pat gali būti stebėjimo įrankis, bilietų pardavimo sistema, finansinė programėlė arba trečiosios šalies paslauga.

Įsivaizduokite įrankį, kuris stebi jūsų infrastruktūrą visą parą: aptikęs kritinį įspėjimą (pilnas diskas, 100 % procesoriaus naudojimas, API klaida), jis gali suaktyvinti žiniatinklio kablį, kuris aktyvuoja korekcinę automatizaciją jūsų orkestravimo platformoje. Tokiu būdu veiksmai taikomi be žmogaus įsikišimo, net ir vidury nakties.

Kitas pavyzdys: išlaidų valdymo platforma gali paleisti žiniatinklio kabliukus, kai sukuriamos arba patvirtinamos naujos operacijos . Turėdama šią informaciją, apskaitos sistema gali akimirksniu užregistruoti operacijas arba vidinis tvirtinimo mechanizmas gali inicijuoti konkrečius darbo eigą pagal sumas, skyrius ar išlaidų tipus.

Visose šiose situacijose „magija“ slypi tame, kad duomenų šaltinis siunčia įspėjimą konkrečiu momentu , nelaukdamas, kol kita sistema jį užklauss. Toks darbo būdas leidžia kurti labai automatizuotas architektūras, pasižyminčias minimalia trintimi ir greitu reagavimu į pokyčius.

Tačiau norint, kad automatizavimas būtų patikimas, variklis, kuris gauna ir apdoroja žiniatinklio kabliukus, turi būti pasirengęs siųsti iš naujo, registruoti klaidas ir apdoroti pakartotinius bandymus, kai kas nors nepavyksta, kad svarbūs įvykiai nebūtų prarasti dėl atsitiktinių sutrikimų.

„Webhooks“ naudojimo versle ir projektuose pranašumai

Verslo požiūriu, žiniatinklio kabliai išsiskiria tuo, kad gali automatizuoti procesus, kuriems anksčiau reikėjo rankinio darbo . Sujungdami programas ir perkeldami duomenis realiuoju laiku, jie panaikina poreikį eksportuoti ir importuoti failus, kopijuoti informaciją rankiniu būdu ar periodiškai vykdyti scenarijus.

Jie taip pat teikia informaciją realiuoju laiku, o tai labai svarbu priimant sprendimus remiantis naujausiais duomenimis . Elektroninės komercijos srityje momentinis žinojimas, kada mokėjimas patvirtintas arba kada prekės nebėra sandėlyje, padeda išvengti brangiai kainuojančių klaidų. Finansų srityje pranešimas apie nepavykusį mokėjimą leidžia greitai reaguoti į klientą.

Dar vienas privalumas yra efektyvumas: vengiant nuolatinės apklausos, sumažinamas nereikalingų API užklausų skaičius , taip sumažinant išteklių sunaudojimą serveriuose, duomenų bazėse ir tinkluose. Duomenys siunčiami tik tada, kai yra kažkas naujo, apie ką reikia pranešti.

Daugeliu atvejų nustatyti žiniatinklio kablį yra daug paprasčiau nei sukurti visą integraciją, pagrįstą sudėtingomis API užklausomis . Jums tereikia gauti paskirties URL iš gaunančios programos, įklijuoti jį į programos, kuri išduos žiniatinklio kablį, konfigūraciją ir pasirinkti, kurie įvykiai jį suaktyvins.

Galiausiai, žiniatinklio kabliai sklandžiai integruojasi su trečiųjų šalių platformomis, tokiomis kaip CRM, palaikymo įrankiai, pranešimų siuntimo sistemos, ERP, mokėjimo šliuzai ir netgi integratoriai, tokie kaip „Zapier“, „Make“ ar individualūs koordinatoriai. Jie yra pagrindinis komponentas kuriant sujungtas programinės įrangos ekosistemas.

Žiniatinklio kabliukų apribojimai ir rizika

Tai ne vien privalumai: žiniatinklio kabliukai taip pat turi savo apribojimų, ir svarbu juos žinoti prieš kuriant visą architektūrą jų pagrindu . Pirma, ne visos rinkoje esančios programos juos palaiko iš karto.

Kai įrankis nesiūlo žiniatinklio kabliukų, reikia pasikliauti išoriniais integratoriais arba pritaikytais kūrėjais, kurie veikia kaip tiltas , periodiškai užklausdami API ir imituodami žiniatinklio kabliuką galutinėje sistemoje. Tai šiek tiek apsunkina architektūrą ir padidina priklausomybę nuo trečiųjų šalių.

Be to, žiniatinklio kabliai yra vienpusio ryšio mechanizmas : viena programa siunčia duomenis kitai, tačiau jie nėra skirti sudėtingiems dvipusiams mainams. Jei jums reikia nuolatinio dialogo, skaitymo ir rašymo operacijų, išplėstinių filtrų ir tikslios kontrolės, ko bet kuriuo metu prašyti, klasikinė API išlieka tinkamesnė.

Kita reikšminga rizika – galimas duomenų praradimas, kai kas nors nutinka ne taip, o niekas to nepastebi . Jei priimantis serveris neveikia arba pateikia klaidas, o siuntėjas netinkamai tvarko pakartotinius bandymus, tam tikri įvykiai gali būti niekada negauti, todėl lieka neaišku, kas buvo prarasta.

Priešingai, tiesioginio API iškvietimo metu paprastai gaunate klaidos kodą ir galite nedelsdami reaguoti . Naudojant žiniatinklio kabliukus, reikia sukurti stebėjimo mechanizmus, pakartotinius bandymus ir įspėjimus, kad atsakingi asmenys būtų informuoti apie nutrūkusią pranešimų grandinę.

Kada prasminga naudoti internetinius kabliukus

„Webhook“ puikiai tinka, kai reikia, kad viena sistema praneštų kitai, kai tik įvyksta konkretus įvykis , bet nereikia nuolatinio ryšio tarp dviejų programų. Kai kurie tipiniai scenarijai tam ypač tinka.

Pavyzdžiui, rinkodaroje „webhooks“ gali būti naudojami prenumeratorių sąrašams atnaujinti, kai kas nors užsiregistruoja mobiliojoje programėlėje, užpildo formą arba pakeičia savo profilį . El. pašto rinkodaros įrankis gauna pranešimą ir akimirksniu atnaujina segmentą, nelaukdamas.

Pardavimų srityje įprasta aktyvuoti žiniatinklio kabliukus, kad būtų įspėti apie užsakymų, siuntų ar potencialių klientų būsenos pasikeitimus . Tokiu būdu pardavimų komanda realiuoju laiku informuojama, kai atsiranda nauja galimybė, atnaujinamas pristatymo adresas arba atliekamas atitinkamas mokėjimas.

Bankininkystės ir finansinių paslaugų srityje žiniatinklio kabliai yra labai svarbūs norint sinchronizuoti likučius, operacijas, kortelių mokėjimus ir klientų duomenų atnaujinimus . Kiekviena operacija ar atitinkamas pakeitimas gali būti automatiškai atspindimas vidinėse sistemose, taip išvengiant rankinių klaidų ir vėlavimų.

Bet kurioje įmonėje, turinčioje daug skirtingų įrankių, žiniatinklio kabliai padeda centralizuoti svarbią informaciją viename taške (CRM, BI ataskaitų suvestinėje, įmonės duomenų bazėje), leidžiant priimti sprendimus turint naujausią verslo vaizdą.

Susijęs straipsnis:

Kaip valdyti skaitmeninius sertifikatus skirtingose ​​žiniatinklio naršyklėse

Izaokas

Aistringas rašytojas apie baitų pasaulį ir technologijas apskritai. Man patinka dalytis savo žiniomis rašydamas, būtent tai ir darysiu šiame tinklaraštyje, parodysiu jums įdomiausius dalykus apie programėles, programinę įrangą, techninę įrangą, technologijų tendencijas ir kt. Mano tikslas – padėti jums paprastai ir smagiai naršyti skaitmeniniame pasaulyje.