Обзор
Webhooks позволяют получать HTTP POST-уведомление на ваш собственный эндпоинт каждый раз, когда завершается преобразование. Используйте их для запуска workflow в Zapier, Make, n8n или любом собственном бэкенде.Webhooks — функция тарифа PRO. Каждый пользователь может зарегистрировать до 3 webhook-эндпоинтов.
Настройка
- Откройте расширение Web2MD и перейдите в раздел Settings.
- Прокрутите до раздела Webhooks.
- Введите URL вашего эндпоинта и нажмите Add Webhook.
- Скопируйте секрет подписи — он понадобится для проверки входящих запросов.
Тело запроса
Когда преобразование завершается, Web2MD отправляетPOST-запрос на ваш эндпоинт со следующим телом в формате JSON:
Безопасность
Каждый webhook-запрос включает заголовокX-Web2MD-Signature с HMAC-SHA256 подписью необработанного тела запроса, подписанной с помощью секрета подписи вашего webhook.
Пример проверки (Node.js)
Поведение при повторных попытках
Если обе попытки завершаются неудачей (ответ не 2xx или таймаут), доставка отменяется. Web2MD не выполняет повторные попытки сверх одного повтора.
Сценарии использования
Zapier / Make / n8n
Используйте триггер Webhook в вашей платформе автоматизации, чтобы запускать workflow при каждом преобразовании страницы — публиковать сообщение в Slack, добавлять строку в таблицу или сохранять в Notion.
Уведомления в Slack
Отправляйте сообщение в канал Slack каждый раз, когда участник команды преобразует страницу, чтобы держать всех в курсе.
Автосохранение во внешнее хранилище
Получайте полный Markdown через REST API (используя
conversionId) и сохраняйте его в S3, Google Drive или собственную базу данных.Аналитический пайплайн
Отслеживайте объём преобразований и типы контента, передавая события webhook в вашу аналитическую систему.