Отримуйте події фронт-офісу Mercateer через webhook’и
Підпишіть endpoint на події Mercateer і одразу отримуйте підписаний пакет даних після завершення дзвінка, надходження ліда або бронювання замовлення. Реєструйте й керуйте endpoint’ами через API або панель керування, і перевіряйте кожну доставку за допомогою HMAC.
Що таке Webhooks?
Webhook’и надсилають події фронт-офісу Mercateer у реальному часі на URL, який ви контролюєте, щоб ваші системи могли реагувати без постійного опитування API. Кожна доставка — це JSON-пакет, підписаний HMAC; ви реєструєте й керуєте endpoint’ами через API або панель керування, а невдалі спроби доставки повторюються з експоненційною затримкою.
Що можна робити з Webhooks
Встановлюється за хвилини
Створіть endpoint
Зареєструйте свій URL і оберіть події для підписки через API або в Налаштуваннях → Розробник. Mercateer поверне секретний ключ для підпису цього endpoint’у. Доступ до API включено у тарифах Crew і Fleet.
Перевірте підпис
При кожній доставці зчитайте позначку часу (t) і підпис (v1) із заголовка підпису, потім обчисліть HMAC-SHA256 рядка "{timestamp}.{raw request body}" зі своїм секретним ключем підпису й порівняйте зі значенням v1. Відхиляйте будь-який запит, який не збігається або чия позначка часу старша за 5 хвилин, щоб реагувати лише на свіжі дані, які справді надійшли від Mercateer. (Помічник перевірки в нашому SDK робить усе це за вас.)
Обробляйте повторні спроби ідемпотентно
Швидко відповідайте кодом 2xx, щоб підтвердити отримання. Невдалі доставки повторюються з експоненційною затримкою, тому використовуйте ID події як ключ у вашому обробнику, щоб ігнорувати дублікати й обробляти кожну подію лише один раз.
Часті запитання
Працює з усім вашим стеком
Mercateer використовує ті самі протоколи, що й інструменти, які ви вже застосовуєте.
Запустіть Mercateer разом із Webhooks
Почніть безкоштовно та підключіть свій фронт-офіс за хвилини.
Без кредитної картки