Modtag Mercateer frontoffice-events som webhooks
Abonnér en endpoint på Mercateer-events og modtag en underskrevet payload det øjeblik et opkald afsluttes, en lead ankommer eller et job bookes. Registrér og administrér endpoints via API’et eller dashboardet, og verificér hver leverance med HMAC.
Hvad er Webhooks?
Webhooks pusher Mercateer frontoffice-events til en URL, du kontrollerer, i realtid – så dine egne systemer kan reagere uden at skulle poll’e API’et. Hver leverance er en JSON-payload underskrevet med HMAC; du registrerer og administrerer endpoints via API’et eller dashboardet, og mislykkede leverancer gentages med forsinkelse.
Hvad du kan gøre med Webhooks
Installer på få minutter
Opret en endpoint
Registrér din URL og vælg de events, du vil abonnere på – via API’et eller under Indstillinger > Udvikler. Mercateer returnerer en signaturhemmelighed for denne endpoint. API-adgang er inkluderet i Crew- og Fleet-planerne.
Verificér signaturen
Ved hver levering læser du tidsstemplet (t) og signaturen (v1) fra signaturheaderen, beregner derefter HMAC-SHA256 af strengen "{timestamp}.{raw request body}" med din signeringsnøgle og sammenligner den med v1-værdien. Afvis enhver forespørgsel, der ikke stemmer, eller hvis tidsstempel er mere end 5 minutter gammelt, så du kun reagerer på friske payloads, der reelt kom fra Mercateer. (Verify-funktionen i vores SDK klarer det hele for dig.)
Håndtér gentagelser idempotent
Svar hurtigt med 2xx for at bekræfte en leverance. Mislykkede leverancer gentages med forsinkelse – så identificér din handler med event-ID’et for at ignorere dubletter og behandle hvert event én gang.
Ofte stillede spørgsmål
Virker med hele din teknologiske løsning
Mercateer taler de samme protokoller som de værktøjer, du allerede bruger.
Sæt Mercateer i arbejde med Webhooks
Start gratis og forbind din frontoffice på få minutter.
Ingen kreditkort påkrævet