Înapoi la Glosar
Technológia
Webhook
Răspuns rapid
Automatikus HTTP-ertesites egy esemeny bekövetkeztekor - a "polling" (lekerdezes) ellentete.
Concluzii cheie
- REST polling: 1-5 percenként megkérdezzük az API-t, hogy "van-e valami új?" -> óránként 12-60 felesleges hívás
- Webhook: a változás pillanata alatt, 1 másodpercen belül érkezik az értesítés -> 0 felesleges hívás, minimális késleltetés
Meghatarozas
A webhook (vagy "HTTP callback") egy olyan mechanizmus, amelyen keresztul egy rendszer automatikusan kuld egy HTTP POST kerest egy elöre beallitott URL-re, amikor egy esemeny törtenik (uj rendeles, kiallitott szamla, visszaigazolt szallitas).
Miert hatekonyabb, mint a polling?
- REST polling: 1-5 percenként megkérdezzük az API-t, hogy "van-e valami új?" -> óránként 12-60 felesleges hívás
- Webhook: a változás pillanata alatt, 1 másodpercen belül érkezik az értesítés -> 0 felesleges hívás, minimális késleltetés
Webhook-kent elerhető CRMconnect esemenyek
- order.created / order.shipped / order.delivered (rendelés létrehozása, kiszállítása, kézbesítése)
- invoice.issued / invoice.paid (számla kiállítása, kifizetése)
- inventory.low_stock / inventory.reserved (alacsony készletszint, foglalt készlet)
- partner.created / partner.updated (partner létrehozása, adatváltozása)
- chargeback.received (visszatérítési igény érkezése)
A webhook-fogadas legjobb gyakorlatai
- Válaszoljon gyorsan HTTP 200 kóddal (5 másodpercen belül), a feldolgozást végezze aszinkron módon
- Ellenőrizze az alairast (HMAC) a biztonsag erdekeben
- Idempotencia: ugyanaz az esemeny többször is kezbesitesre kerulhet, a rendszernek fel kell ismernie az ismetlest
Actualizat:
Întrebări frecvente
Mi törtenik, ha az en URL-em ideiglenesen nem elerhető?+
A CRMconnect exponencialis visszalepessel (exponential backoff) ujraprobalja a kuldest (5 perc, 30 perc, 2 ora, 12 ora, 24 ora elteltevel). 5 sikertelen kiserlet utan az esemeny egy dead-letter queue-ba kerul, amely az admin feluleten ellenőrizhető.