Mechanizm tworzenia webhooków
Webhooks (w odróżnieniu od API) to prosty i skuteczny mechanizm komunikacji między wFirma.pl, a systemem zewnętrznym (np. sklepem internetowym). Pozwala na wysyłanie żądań POST (requestów) na dowolny adres URL, bezpośrednio po wykonaniu zdefiniowanych akcji, bez potrzeby cyklicznego odpytywania aplikacji przez API. Dzięki zastosowaniu webhooków znacznie zmniejsza się obciążenie serwera aplikacji.
Dodawanie webhooków
Webhooki można dodać w zakładce: USTAWIENIA w sekcji INNE » WEBHOOKS poprzez akcję Dodaj.
W otwartym oknie Inne - Webhooks można dodać za pomocą przycisku Dodaj.
W oknie Dodawanie webhooka dostępne są pola:
Post URL - pozwalający na wysyłanie informacji pod ustalony przez administratora adres url
Zdarzenie - lista konkretnych zdarzeń odnośnie których informacja jest przekazywana
Typ danych - do wyboru JSON lub XML
Obsługiwane zdarzenia i przykładowy skrypt
Lista obsługiwanych zdarzeń:
Faktury (Dodanie, Modyfikacja, Usunięcie),
Kontrahenci (Dodanie),
Płatności (Dodanie),
Produkty (Dodanie, Zmiana ilości na magazynie),
Ustawienia (Zweryfikowanie firmy),
Zmiana pakietu,
Zmiana okresu pakietu;
Przykładowy skrypt odbierający webhooka: