Ontvang Mercateer-voorfrontkantoorgebeurtenisse as webhooks
Teken ’n eindpunt in vir Mercateer-gebeurtenisse en ontvang ’n ondertekende inhoud die oomblik wanneer ’n oproep eindig, ’n potensiële kliënt aankom, of ’n werk bespreek word. Registreer en bestuur eindpunte vanaf die API of paneel, en verifieer elke lewering met HMAC.
Wat is Webhooks?
Webhooks stuur Mercateer-voorfrontkantoorgebeurtenisse in werklike tyd na ’n URL wat jy beheer, sodat jou eie stelsels kan reageer sonder om die API te peil. Elke lewering is ’n JSON-inhoud wat met HMAC onderteken is; jy registreer en bestuur eindpunte vanaf die API of paneel, en mislukte lewerings probeer weer met terugtrekking.
Wat jy met Webhooks kan doen
Installeer binne minute
Skep ’n eindpunt
Registreer jou URL en kies die gebeurtenisse waaraan jy wil inteken, vanaf die API of in Instellings, dan Ontwikkelaar. Mercateer gee ’n ondertekeninggeheim vir daardie eindpunt terug. API-toegang is ingesluit op die Crew- en Fleet-planne.
Verifieer die handtekening
Lees by elke aflewering die tydstempel (t) en handtekening (v1) uit die handtekening-opskrif, bereken dan die HMAC-SHA256 van die string "{timestamp}.{raw request body}" met jou ondertekengeheim en vergelyk dit met die v1-waarde. Verwerp enige versoek wat nie ooreenstem nie, of waarvan die tydstempel meer as 5 minute oud is, sodat jy net op vars vragte reageer wat werklik van Mercateer af gekom het. (Ons SDK se verifikasiehelper doen dit alles vir jou.)
Hanteer herprobeer idempotent
Beantwoord vinnig met 2xx om ’n lewering te bevestig. Mislukte lewerings probeer weer met terugtrekking, dus gebruik die gebeurtenis-ID as sleutel vir jou hanteraar om duplikate te ignoreer en elke gebeurtenis een keer te verwerk.
Gereelde vrae
Werk saam met jou hele stapel
Mercateer gebruik dieselfde protokolle as die gereedskap wat jy reeds gebruik.
Laat Mercateer werk met Webhooks
Begin gratis en koppel jou voorfrontkantoor binne minute.
Geen kredietkaart benodig nie