Webhooks для SnapStack
Настройте асинхронные уведомления для завершения длительных задач рендеринга и обработки ошибок в реальном времени.
Настройка и конфигурация
SnapStack отправляет POST-запросы на ваш URL-адрес сразу после завершения задачи создания скриншота. Это позволяет вашему бэкенду (например, на Node.js или Python) обрабатывать файлы без ожидания таймаута HTTP-запроса.
Для настройки перейдите в раздел Settings > API & Webhooks в панели управления. Укажите конечную точку (Endpoint URL) и секретный ключ подписи для верификации входящих запросов.
1. Создание подписи (Signature)
Включите опцию webhook_secret в настройках проекта. SnapStack использует алгоритм HMAC-SHA256 для подписи каждого уведомления. Проверяйте заголовок X-SnapStack-Signature на вашем сервере.
2. Структура полезной нагрузки
Тело запроса содержит JSON-объект с полями: job_id, status (success/error), url (ссылка на скриншот) и метаданные времени обработки.
3. Политика повторов (Retries)
Если ваш сервер отвечает кодом отличным от 2xx, мы автоматически повторяем запрос 3 раза с экспоненциальной задержкой (1с, 5с, 30с). Это гарантирует доставку даже при кратковременных сбоях.