Definicja
Webhook to odwrotność API polling — zamiast system B pytać "czy coś nowego?", system A sam powiadamia B przez HTTP POST gdy wystąpi zdarzenie.
Webhook vs Polling
| Aspekt | Polling | Webhook |
|---|---|---|
| Inicjator | Odbiorca (co X sekund) | Nadawca (na zdarzenie) |
| Opóźnienie | Do X sekund | Natychmiastowe |
| Obciążenie | Duże (zbędne zapytania) | Minimalne |
| Przykład | GET /api/orders?since=... co minutę |
Stripe wysyła POST na Twój endpoint |
Przykłady webhooków
| Serwis | Zdarzenie | Webhook |
|---|---|---|
| Stripe | Płatność zrealizowana | POST do /webhooks/stripe |
| GitHub | Push do repo | POST do /webhooks/github |
| Slack | Wiadomość na kanale | POST do /webhooks/slack |
Dlaczego BA powinien znać?
Definiując wymagania integracyjne, BA musi wiedzieć: - czy integracja jest synchroniczna (API call) czy asynchroniczna (webhook), - jakie zdarzenia wyzwalają webhook, - co się dzieje gdy webhook się nie dostarczy (retry, dead letter queue).