← Powrót do słownika

Kategoria: Technologia

Webhook

Szybka odpowiedź: Automatyczne powiadomienie wypychane (HTTP push) wysyłane po wystąpieniu zdarzenia — przeciwieństwo odpytywania (polling).

Najważniejsze wnioski

REST polling: odpytywanie API co 1-5 minut z pytaniem „czy jest coś nowego?” → 12-60 bezużytecznych wywołań na godzinę
Webhook: powiadomienie w czasie poniżej 1 sekundy od zmiany → 0 zbędnych wywołań, minimalne opóźnienie

Definicja

Webhook (lub „HTTP callback”) to mechanizm, za pomocą którego system automatycznie wysyła żądanie HTTP POST pod wstępnie skonfigurowany adres URL w momencie wystąpienia zdarzenia (nowe zamówienie, wystawienie faktury, potwierdzenie dostawy).

Dlaczego jest lepszy niż polling (odpytywanie)

REST polling: odpytywanie API co 1-5 minut z pytaniem „czy jest coś nowego?” → 12-60 bezużytecznych wywołań na godzinę

Webhook: powiadomienie w czasie poniżej 1 sekundy od zmiany → 0 zbędnych wywołań, minimalne opóźnienie

Zdarzenia Azuvio dostępne jako webhooki

order.created / order.shipped / order.delivered (zamówienia)

invoice.issued / invoice.paid (faktury)

inventory.low_stock / inventory.reserved (stany magazynowe)

partner.created / partner.updated (dane kontrahentów)

chargeback.received (zwroty płatności)

Dobre praktyki dla odbiorcy webhooków

Szybka odpowiedź kodem HTTP 200 (poniżej 5 sek.) i przetwarzanie asynchroniczne

Weryfikacja podpisu (HMAC) w celu zapewnienia bezpieczeństwa

Idempotentność: to samo zdarzenie może zostać dostarczone więcej niż raz

Najczęstsze pytania

Co się stanie, jeśli mój adres URL będzie nieosiągalny?: Azuvio ponawia próby z wykładniczym czasem oczekiwania (5 min, 30 min, 2h, 12h, 24h). Po 5 nieudanych próbach zdarzenie trafia do kolejki dead-letter, widocznej w panelu administratora.

Gdzie wchodzi Azuvio

Integrări Azuvio

Powiązane pojęcia

REST API — Standardowy interfejs programistyczny HTTP umożliwiający wymianę danych między systemami.
Smart Layer — Nowoczesna warstwa orkiestracji nad Twoim systemem ERP – dodaje moduły OMS, WMS, EDI i integracje z marketplace'ami bez konieczności wymiany oprogramowania księgowego.

Aktualizacja: 2026-07-17