Webhook nədir və ondan necə istifadə edirsiniz?

Webhooks veb-əsaslı proqramlara xüsusi geri çağırışlardan istifadə etməklə qarşılıqlı əlaqə yaratmağa imkan verir.

Veb-qancalardan istifadə veb-proqramlara avtomatik olaraq digər veb-proqramlarla əlaqə yaratmağa imkan verir.

Bir sistemin (mövzunun) bəzi məlumatlar üçün başqa bir sistemi (müşahidəçi) sorğusunu davam etdirdiyi ənənəvi sistemlərdən fərqli olaraq, veb-qancalar müşahidəçiyə hər hansı hadisə baş verdikdə məlumatları avtomatik olaraq subyektin sisteminə köçürməyə imkan verir.

Bu, subyekt tərəfindən daimi monitorinq ehtiyacını aradan qaldırır. Webhooks tamamilə İnternetdə işləyir və buna görə də sistemlər arasında bütün əlaqə HTTP mesajları şəklində baş verməlidir.

Veb kancalardan istifadə

Webhooks müşahidəçinin sistemində hadisə baş verdikdə xəbərdar edilməli olan subyektin sistemində API-lərə işarə edən statik URL-lərin mövcudluğuna əsaslanır. Buna misal olaraq istifadəçinin Amazon hesabına yerləşdirilmiş bütün sifarişləri toplamaq və idarə etmək üçün nəzərdə tutulmuş veb tətbiqi ola bilər. Bu ssenaridə Amazon müşahidəçi kimi çıxış edir və Xüsusi Sifariş İdarəetmə Veb Proqramı subyekt kimi çıxış edir.

Xüsusi veb proqramın yaradılmış sifarişi yoxlamaq üçün vaxtaşırı Amazon API-lərinə zəng etmək əvəzinə, fərdi web proqramında yaradılmış veb-qanca Amazon-a qeydiyyatdan keçmiş URL vasitəsilə veb proqramında yeni yaradılmış sifarişi avtomatik təqdim etməyə imkan verəcək. Buna görə də, webhook-ların istifadəsini təmin etmək üçün subyektin müşahidəçidən hadisə bildirişlərini qəbul edən təyin edilmiş URL-ləri olmalıdır. Bu, obyektə əhəmiyyətli yükü azaldır, çünki HTTP zəngləri yalnız hadisə baş verdikdə iki tərəf arasında edilir.

Səsvermə əsaslı sistemlər və webhook əsaslı sistemlər

Müşahidəçi tərəfindən subyektin webhooku çağırıldıqdan sonra subyekt bu yeni təqdim edilmiş məlumatla müvafiq hərəkəti edə bilər. Tipik olaraq, webhooks müəyyən bir URL-ə POST sorğuları vasitəsilə edilir. POST sorğuları obyektə əlavə məlumat göndərmək imkanı verir. Bundan əlavə, o, hər bir hadisə üçün ayrıca webhook URL-ləri yaratmaq əvəzinə bir sıra müxtəlif mümkün hadisələri müəyyən etmək üçün də istifadə edilə bilər.

Webhook iş prosesi

Tətbiqinizdə daxil olan webhooks tətbiq etmək üçün aşağıdakı əsas addımları yerinə yetirməlisiniz:

• Tətbiq serverinizdə HTTP POST zənglərini qəbul edən və emal edən API son nöqtəsini nümayiş etdirin
• Potensial webhook istifadəçiləri üçün bu son nöqtəyə girişi təmin edin. API son nöqtəsi müvafiq şərtlər yerinə yetirildikdə məlumat mənbəyi tətbiqini çağıracaq.
• POST məlumatlarını emal edin və statusu göstərmək üçün veb-qancalı zəng təşəbbüskarına cavab qaytarın. Bu addım mövcud və ya olmaya bilər.

Webhooks və API

Həm webhooks, həm də API-lər proqramlar arasında əlaqə yaratmaq məqsədi daşıyır. Bununla belə, tətbiq inteqrasiyasına nail olmaq üçün Webhooks-dan API-lərdən istifadə etməyin bəzi fərqli üstünlükləri və mənfi cəhətləri var.

Aşağıdakı məqamlar həyata keçirilən sistemə daha uyğun olarsa, veb-qancalar daha yaxşı həllər olur:

• Verilənlər serverdə tez-tez yenilənirsə, müştəridən serverə lazımsız API zəngləri aradan qaldırıldığı üçün webhooks daha yaxşı həllər olur. resthooks.com-a görə, API sorğularının 98,5%-i boşa gedir.
• Webhooks yaxın real vaxt məlumat yeniləmələrini tələb edən sistemlər üçün daha yaxşı həllər təmin edir. API sorğuları adətən müəyyən edilmiş intervallarla keçirilir ki, bu da canlı məlumatların yenilənməsinin qarşısını ala bilər. Webhooks ilə yeniləmələr webhook işə salınan kimi serverdən müştəriyə göndərilir.

API-dən istifadə bəzi digər hallarda veb-qancalara üstünlük verilməlidir.

Nəzərə alınmalı şeylər

Webhooks-da API-lərdən istifadə etmək üçün nəzərə alınmalı vacib məqamlar bunlardır:

• API-dən istifadə serverdən verilənlərin nə vaxt sorğulanacağını və həmçinin serverdən nə qədər məlumatın sorğulanacağını daha çox fərdiləşdirməyə imkan verir. Sorğulanacaq məlumatların miqdarı API sorğu ölçüsü ilə tənzimlənir. Webhooks ilə server, ümumiyyətlə, verilənlərin nə vaxt göndəriləcəyinə qərar verir.
• Çox dəyişkən verilənlərə malik sistemlər üçün (məsələn, real vaxt sistemləri, IoT sistemləri və s.) API əsaslı sorğu daha yaxşı seçim ola bilər, çünki hər bir API çağırışı üçün istifadə edilə bilən cavabların yüksək ehtimalı var.
• REST son nöqtələri oflayn olduqda, serverdən veb-qanca vasitəsilə göndərilən məlumatların müştəri tərəfindən tamamilə nəzərə alınmaması mümkündür. Serverdə belə uğursuz təkanları təkrar sınamaq üçün mexanizm yoxdursa, məlumat yeniləmələri tamamilə itirilir.

Webhook oflayn olduqda serverdən göndərilən məlumatların itirilməsi ehtimalı ilə məşğul olmaq üçün siz həmin zəngləri arxivləşdirmək üçün hadisə mesajlaşma növbəsindən istifadə edə bilərsiniz. Bu cür funksionallığı təmin edən platformalara nümunələr daxildir RabbitMQ o Amazonun Sadə Növbə Xidməti (SQS). Hər ikisi webhook zəngini qaçırmaq ehtimalının qarşısını alan vasitəçi mesajlaşma saxlama vasitələri kimi fəaliyyət göstərmək üçün nəzərdə tutulmuşdur.

Ercole Palmeri