Získajte udalosti prednej kancelárie Mercateer ako webhooky
Prihláste koncový bod na udalosti Mercateer a prijmite podpísaný obsah hneď po ukončení hovoru, príchode potenciálneho zákazníka alebo rezervácii práce. Koncové body registrujte a spravujte cez API alebo nástenku a overujte každé doručenie pomocou HMAC.
Čo je Webhooks?
Webhooky odosielať udalosti prednej kancelárie Mercateer v reálnom čase na URL adresu, ktorú ovládate, aby vaše systémy mohli reagovať bez opakovaného dotazovania API. Každé doručenie je JSON obsah podpísaný HMAC, koncové body registrujete a spravujete cez API alebo nástenku a neúspešné pokusy sa opakujú s postupným oneskorením.
Čo môžete robiť s Webhooks
Nainštalujte za pár minút
Vytvorte koncový bod
Zaregistrujte svoju URL adresu a vyberte udalosti, na ktoré sa chcete prihlásiť – buď cez API alebo v Nastaveniach → Vývojár. Mercateer vráti podpisové tajomstvo pre tento koncový bod. Prístup k API je zahrnutý v plánoch Crew a Fleet.
Overte podpis
Pri každom doručení načítajte časovú pečiatku (t) a podpis (v1) z hlavičky s podpisom, potom vypočítajte HMAC-SHA256 reťazca "{timestamp}.{raw request body}" so svojím podpisovým tajomstvom a porovnajte ho s hodnotou v1. Každú požiadavku, ktorá nesedí alebo má časovú pečiatku staršiu ako 5 minút, odmietnite, aby ste spracovali len čerstvé dáta, ktoré naozaj prišli z Mercateer. (Pomocná funkcia verify v našom SDK to celé urobí za vás.)
Spracujte opakovania idempotentne
Rýchlo odpovedzte kódom 2xx na potvrdenie doručenia. Neúspešné doručenia sa opakujú s postupným oneskorením, preto naväzujte svoj spracovateľ na ID udalosti, aby ste ignorovali duplikáty a každú udalosť spracovali len raz.
Často kladené otázky
Kompatibilné s celým vaším technologickým zásobníkom
Mercateer používa rovnaké protokoly ako nástroje, ktoré už používate.
Zapojte Mercateer spolu s Webhooks
Začnite zdarma a prepojte svoju recepciu za pár minút.
Bez nutnosti zadávať platobnú kartu