Перейти к основному содержанию

Обзор

Webhooks позволяют получать HTTP POST-уведомление на ваш собственный эндпоинт каждый раз, когда завершается преобразование. Используйте их для запуска workflow в Zapier, Make, n8n или любом собственном бэкенде.
Webhooks — функция тарифа PRO. Каждый пользователь может зарегистрировать до 3 webhook-эндпоинтов.

Настройка

  1. Откройте расширение Web2MD и перейдите в раздел Settings.
  2. Прокрутите до раздела Webhooks.
  3. Введите URL вашего эндпоинта и нажмите Add Webhook.
  4. Скопируйте секрет подписи — он понадобится для проверки входящих запросов.

Тело запроса

Когда преобразование завершается, Web2MD отправляет POST-запрос на ваш эндпоинт со следующим телом в формате JSON:

Безопасность

Каждый webhook-запрос включает заголовок X-Web2MD-Signature с HMAC-SHA256 подписью необработанного тела запроса, подписанной с помощью секрета подписи вашего webhook.
Всегда проверяйте подпись перед обработкой webhook. Это предотвращает отправку злоумышленниками поддельных запросов на ваш эндпоинт.

Пример проверки (Node.js)

Используйте crypto.timingSafeEqual вместо === для предотвращения атак по времени при сравнении подписей.

Поведение при повторных попытках

Если обе попытки завершаются неудачей (ответ не 2xx или таймаут), доставка отменяется. Web2MD не выполняет повторные попытки сверх одного повтора.

Сценарии использования

Zapier / Make / n8n

Используйте триггер Webhook в вашей платформе автоматизации, чтобы запускать workflow при каждом преобразовании страницы — публиковать сообщение в Slack, добавлять строку в таблицу или сохранять в Notion.

Уведомления в Slack

Отправляйте сообщение в канал Slack каждый раз, когда участник команды преобразует страницу, чтобы держать всех в курсе.

Автосохранение во внешнее хранилище

Получайте полный Markdown через REST API (используя conversionId) и сохраняйте его в S3, Google Drive или собственную базу данных.

Аналитический пайплайн

Отслеживайте объём преобразований и типы контента, передавая события webhook в вашу аналитическую систему.

Тестирование webhooks

Во время разработки используйте такие инструменты, как webhook.site или ngrok, чтобы открыть локальный эндпоинт и проверить входящие данные перед развёртыванием обработчика в продакшене.