Czym jest webhook i dlaczego jest wygodniejszy niż odpytywanie?

Przy API to Państwa system pyta: czy ta wiadomość już dotarła? Webhook to odwraca — to Państwo dostają powiadomienie, gdy tylko coś się zmieni.

Dlaczego to lepsze

Bez webhooka trzeba pytać bez końca. Pytając co minutę, wykonuje się setki bezużytecznych wywołań na każde jedno, które coś przynosi. Pytając co godzinę, dowiadują się Państwo za późno.

Czego potrzeba

Adresu na własnym serwerze, który może odebrać wiadomość i jest zawsze osiągalny. To ostatnie jest punktem, który się lekceważy: jeśli serwer na chwilę przestanie działać, powiadomienie przepadnie.

Dwie rzeczy, które warto od razu zrobić dobrze

Odpowiadać szybko — wiadomość przetwarzać dopiero potem, a nie przed odpowiedzią. Wolne potwierdzenie prowadzi do ponownych prób.

Liczyć się z duplikatami. Przy problemie z siecią to samo powiadomienie może przyjść dwa razy. Przetwarzanie musi to znieść, na przykład dzięki zapamiętywaniu identyfikatora wiadomości.

Do czego się ich używa

Do statusów doręczenia i odpowiedzi przychodzących. Dokładnie tych dwóch rzeczy, o których chce się wiedzieć, gdy tylko nastąpią.