Вебхук дегеніміз не және оны қалай пайдаланасыз?

Webhooks веб-негізіндегі қолданбаларға теңшелетін кері қоңырауларды пайдалану арқылы өзара әрекеттесуге мүмкіндік береді.

Webhooks пайдалану веб-қосымшаларға басқа веб-қолданбалармен автоматты түрде байланысуға мүмкіндік береді.

Бір жүйе (субъект) кейбір деректер үшін басқа жүйені (бақылаушы) сұрауын жалғастыратын дәстүрлі жүйелерден айырмашылығы, веб-хуктар бақылаушыға оқиға орын алған сайын субъектінің жүйесіне деректерді автоматты түрде жіберуге мүмкіндік береді.

Бұл субъектінің тұрақты бақылау қажеттілігін жояды. Вебхуктар толығымен Интернетте жұмыс істейді, сондықтан жүйелер арасындағы барлық байланыс HTTP хабарламалары түрінде болуы керек.

Вебхуктарды пайдалану

Веб-хуктар бақылаушының жүйесінде оқиға орын алған кезде хабарлануы қажет субъект жүйесінде API интерфейстерін көрсететін статикалық URL мекенжайларының болуына сүйенеді. Бұған мысал ретінде пайдаланушының Amazon тіркелгісінде орналастырылған барлық тапсырыстарды жинауға және басқаруға арналған веб-бағдарлама болуы мүмкін. Бұл сценарийде Amazon бақылаушы ретінде әрекет етеді және тапсырысты басқарудың пайдаланушылық веб қолданбасы субъект ретінде әрекет етеді.

Жасалған тапсырысты тексеру үшін пайдаланушы веб-бағдарламасын мерзімді түрде Amazon API интерфейстеріне шақырудың орнына, пайдаланушы веб қолданбасында жасалған веб-хук Amazon компаниясына веб-бағдарламада жаңадан жасалған тапсырысты тіркелген URL арқылы автоматты түрде жіберуге мүмкіндік береді. Сондықтан, веб-хуктарды пайдалануды қосу үшін тақырыпта бақылаушыдан оқиға хабарландыруларын қабылдайтын тағайындалған URL мекенжайлары болуы керек. Бұл нысанға айтарлықтай жүктемені азайтады, өйткені HTTP қоңыраулары оқиға орын алған кезде ғана екі тарап арасында жасалады.

Сауалнамаға негізделген жүйелер және веб-хук негізіндегі жүйелер

Бақылаушы субъект веб-хукты шақырғаннан кейін, субъект осы жаңадан жіберілген деректермен сәйкес әрекетті жасай алады. Әдетте, веб-хуктар белгілі бір URL мекенжайына POST сұраулары арқылы жасалады. POST сұраулары нысанға қосымша ақпаратты жіберуге мүмкіндік береді. Оған қоса, оны әр оқиға үшін бөлек веб-құк URL мекенжайларын жасаудың орнына әртүрлі ықтимал оқиғалардың қатарын анықтау үшін пайдалануға болады.

Webhook жұмыс процесі

Қолданбаңызда кіріс веб-хуктарды енгізу үшін келесі негізгі қадамдарды орындау қажет:

• HTTP POST қоңырауларын қабылдайтын және өңдейтін қолданба серверінде API соңғы нүктесін көрсетіңіз
• Потенциалды вебхук пайдаланушылары үшін осы соңғы нүктеге кіруді қамтамасыз етіңіз. API соңғы нүктесі сәйкес шарттар орындалған сайын деректер көзі қолданбасын шақырады.
• POST деректерін өңдеңіз және күйді көрсету үшін вебхук қоңырауының бастамашысына жауап қайтарыңыз. Бұл қадам болуы немесе болмауы мүмкін.

Webhooks және API интерфейстері

Webhooks да, API интерфейстері де қолданбалар арасында байланысты орнату мақсатын көздейді. Дегенмен, қолданбаларды біріктіруге қол жеткізу үшін API интерфейстеріне қарағанда Webhooks пайдаланудың кейбір ерекше артықшылықтары мен кемшіліктері бар.

Келесі тармақтар енгізілген жүйеге көбірек сәйкес келсе, веб-хуктар жақсырақ шешім болады:

• Деректер серверде жиі жаңартылса, клиенттен серверге қажет емес API қоңыраулары жойылатындықтан, веб-хуктар жақсырақ шешім болады. Reshooks.com мәліметтері бойынша, API сауалнамаларының 98,5% босқа кетеді.
• Вебхуктар нақты уақыттағы деректерді жаңартуды қажет ететін жүйелер үшін жақсырақ шешімдерді қосады. API сауалнамасы әдетте белгіленген аралықтарда орындалады, бұл тікелей деректерді жаңартуға кедергі келтіруі мүмкін. Вебхуктардың көмегімен жаңартулар веб-хук іске қосылғаннан кейін серверден клиентке жіберіледі.

API пайдалану кейбір басқа жағдайларда веб-хуктарға қарағанда жақсырақ болуы керек.

Қарастырылатын нәрселер

Webhooks-те API пайдалану үшін қарастырылатын маңызды нәрселер:

• API пайдалану серверден деректерге қашан сұрау керектігін және серверден қанша деректер сұрау керектігін көбірек теңшеуге мүмкіндік береді. Сұрау салынатын деректер көлемі API сұрау өлшемімен реттеледі. Вебхуктармен сервер әдетте деректерді және қашан жіберілетінін шешеді.
• Жоғары айнымалы деректері бар жүйелер үшін (мысалы, нақты уақыттағы жүйелер, IoT жүйелері және т.б.) API негізіндегі сауалнама жақсы нұсқа болуы мүмкін, өйткені әрбір API қоңырауы үшін қолдануға болатын жауаптардың жоғары ықтималдығы бар.
• REST соңғы нүктелері желіден тыс болған жағдайда, серверден веб-хук арқылы жіберілген деректерді клиент толығымен елемеуі мүмкін. Серверде мұндай сәтсіз итеруді қайталау механизмі болмаса, деректер жаңартулары толығымен жоғалады.

Веб-хук желіден тыс күйде болғанда серверден жіберілген деректерді жоғалту мүмкіндігімен күресу үшін сол қоңырауларды мұрағаттау үшін оқиға туралы хабар алмасу кезегін пайдалануға болады. Мұндай функционалдылықты қамтамасыз ететін платформалардың мысалдары мыналарды қамтиды Қоян MQ o Amazon қарапайым кезек қызметі (SQS). Екеуі де вебхук қоңырауын өткізіп алу мүмкіндігін болдырмайтын делдал хабар алмасу құралдары ретінде әрекет етуге арналған.

Ercole Palmeri