Rep esdeveniments de la oficina d'atenció de Mercateer mitjançant webhooks
Subscriu un punt final als esdeveniments de Mercateer i rep una càrrega útil signada en el moment que acaba una trucada, arriba un client potencial o es reserva una feina. Registra i gestiona punts finals des de l'API o el tauler de control, i verifica cada entrega amb HMAC.
Què és Webhooks?
Els webhooks envien esdeveniments de la oficina d'atenció de Mercateer a una URL que controless en temps real, de manera que els teus sistemes poden reaccionar sense consultar contínuament l'API. Cada entrega és una càrrega útil JSON signada amb HMAC; pots registrar i gestionar punts finals des de l'API o el tauler de control, i les entregues fallides es reintentin amb intervals creixents.
El que pots fer amb Webhooks
Instal·la en minuts
Crea un punt final
Registra la teva URL i selecciona els esdeveniments als quals subscriure't, des de l'API o a Configuració > Desenvolupador. Mercateer et retorna un secret de signatura per a aquest punt final. L'accés a l'API està inclòs als plans Crew i Fleet.
Verifica la signatura
A cada entrega, llegeix la marca de temps (t) i la signatura (v1) de la capçalera de signatura, després calcula l'HMAC-SHA256 de la cadena "{timestamp}.{raw request body}" amb el teu secret de signatura i compara'l amb el valor v1. Rebutja qualsevol petició que no coincideixi, o la marca de temps de la qual tingui més de 5 minuts, així només actues sobre càrregues recents que realment vénen de Mercateer. (La funció auxiliar de verificació del nostre SDK ho fa tot per tu.)
Gestiona reintents de forma idempotent
Respon ràpidament amb un codi 2xx per reconèixer una entrega. Les entregues fallides es reintentin amb intervals creixents, així que identifica el teu gestor amb l'ID de l'esdeveniment per ignorar duplicats i processar cada esdeveniment només una vegada.
Preguntes freqüents
Funciona amb tot el teu entorn
Mercateer parla els mateixos protocols que les eines que ja utilitzes.
Posa Mercateer a treballar amb Webhooks
Comença gratuïtament i connecta la teva recepció en minuts.
No cal targeta de crèdit