Çfarë është një uebhook dhe si e përdorni atë?

Uebhook-et lejojnë që aplikacionet e bazuara në ueb të ndërveprojnë përmes përdorimit të kthimeve të personalizuara.

Përdorimi i uebhooks lejon që aplikacionet në ueb të komunikojnë automatikisht me aplikacione të tjera në internet.

Ndryshe nga sistemet tradicionale ku një sistem (subjekt) vazhdon të anketojë një sistem tjetër (vëzhgues) për disa të dhëna, webhooks i lejojnë vëzhguesit të shtyjë automatikisht të dhënat në sistemin e subjektit sa herë që ndodh një ngjarje.

Kjo eliminon nevojën për monitorim të vazhdueshëm nga subjekti. Webhooks funksionojnë tërësisht në internet dhe për këtë arsye i gjithë komunikimi ndërmjet sistemeve duhet të bëhet në formën e mesazheve HTTP.

Përdorimi i grepave në internet

Webhooks mbështeten në praninë e URL-ve statike që tregojnë API-të në sistemin e subjektit që duhet të njoftohen kur ndodh një ngjarje në sistemin e vëzhguesit. Një shembull i kësaj do të ishte një aplikacion ueb i krijuar për të mbledhur dhe menaxhuar të gjitha porositë e vendosura në llogarinë e një përdoruesi në Amazon. Në këtë skenar, Amazon vepron si vëzhgues dhe aplikacioni në internet i menaxhimit të porosive me porosi vepron si subjekt.

Në vend që aplikacioni i personalizuar i ueb-it të telefonojë periodikisht API-të e Amazon për të kontrolluar për një porosi të krijuar, një uebhook i krijuar në aplikacionin e personalizuar të ueb-it do t'i lejonte Amazon të dorëzojë automatikisht një porosi të krijuar rishtazi në aplikacionin uebi nëpërmjet një URL të regjistruar. Prandaj, për të mundësuar përdorimin e grepave në internet, subjekti duhet të ketë URL të përcaktuara që pranojnë njoftimet e ngjarjeve nga vëzhguesi. Kjo zvogëlon një ngarkesë të konsiderueshme në objekt pasi thirrjet HTTP bëhen midis dy palëve vetëm kur ndodh një ngjarje.

Sisteme të bazuara në votime vs sisteme të bazuara në uebhook

Pasi vrojtuesi të thërrasë rrjetin e subjektit, subjekti mund të ndërmarrë veprimet e duhura me këto të dhëna të paraqitura rishtazi. Në mënyrë tipike, lidhjet në internet bëhen nëpërmjet kërkesave POST në një URL specifike. Kërkesat POST ju lejojnë të dërgoni informacion shtesë në objekt. Për më tepër, mund të përdoret gjithashtu për të identifikuar midis një numri ngjarjesh të ndryshme të mundshme në vend që të krijohen URL të veçanta të grepave të internetit për secilën ngjarje.

Rrjedha e punës e Uebhook

Për të zbatuar uebhooks hyrës në aplikacionin tuaj, duhet të kryeni hapat bazë të mëposhtëm:

• Ekspozoni një pikë fundore API në serverin tuaj të aplikacionit që pranon dhe përpunon thirrjet HTTP POST
• Siguroni qasje në këtë pikë përfundimtare për përdoruesit e mundshëm të uebhook-ut. Pika përfundimtare e API do të thërrasë një aplikacion të burimit të të dhënave sa herë që plotësohen kushtet përkatëse.
• Përpunoni të dhënat POST dhe ktheni një përgjigje tek iniciatori i thirrjes në uebhook për të treguar statusin. Ky hap mund të jetë ose jo.

Uebhooks kundrejt API-ve

Si webhooks ashtu edhe API-të kanë për qëllim vendosjen e komunikimit ndërmjet aplikacioneve. Megjithatë, ka disa avantazhe dhe disavantazhe të dallueshme të përdorimit të Webhooks mbi API-të për të arritur integrimin e aplikacioneve.

Uebhooks priren të jenë zgjidhje më të mira nëse pikat e mëposhtme janë më të rëndësishme për sistemin e implementuar:

• Nëse të dhënat përditësohen shpesh në server, webhook-et priren të jenë zgjidhje më të mira pasi eliminohen thirrjet e panevojshme API nga klienti në server. Sipas resthooks.com, 98,5% e sondazheve të API shkojnë dëm.
• Uebhooks mundësojnë zgjidhje më të mira për sistemet që kërkojnë përditësime afërsisht të të dhënave në kohë reale. Sondazhet API zakonisht zhvillohen në intervale të caktuara që mund të parandalojnë përditësimin e të dhënave të drejtpërdrejta. Me webhooks, përditësimet dërgohen nga serveri te klienti sapo të aktivizohet uebhook.

Përdorimi i API-së duhet të preferohet mbi webhook-et në disa situata të tjera.

Gjërat për t'u marrë parasysh

Gjërat e rëndësishme që duhen marrë parasysh për përdorimin e API-ve në Webhooks janë:

• Përdorimi i API-së lejon më shumë personalizim se kur duhen anketuar për të dhënat nga një server dhe gjithashtu sa të dhëna duhet të merren nga serveri. Sasia e të dhënave që do të anketohen rregullohet nga madhësia e sondazhit të API. Me webhooks, serveri në përgjithësi vendos për të dhënat dhe kur ato dërgohen.
• Për sistemet me të dhëna shumë të ndryshueshme (si sistemet në kohë reale, sistemet IoT, etj.), Sondazhi i bazuar në API mund të jetë një opsion më i mirë pasi për çdo thirrje API, ka një probabilitet të lartë të përgjigjeve të përdorshme.
• Është e mundur që të dhënat e dërguara nga një server, nëpërmjet një uebhook, të injorohen plotësisht nga klienti në rast se pikat fundore REST janë jashtë linje. Në rast se serveri nuk ka një mekanizëm për të riprovuar shtytje të tilla të dështuara, përditësimet e të dhënave humbasin plotësisht.

Për t'u marrë me mundësinë e humbjes së të dhënave të dërguara nga një server kur webhook shkon jashtë linje, mund të përdorni një radhë mesazhesh ngjarjesh për të arkivuar ato thirrje. Shembuj të platformave që ofrojnë një funksionalitet të tillë përfshijnë LepuriMQ o Shërbimi i thjeshtë i radhës i Amazon (SQS). Të dyja janë projektuar për të vepruar si pajisje ndërmjetëse për ruajtjen e mesazheve që shmangin mundësinë e mungesës së një telefonate në uebhook.

Ercole Palmeri