К содержанию
ShotlyДокументация API

Автоматизация

Мониторы, visual diff и уведомления

Запускайте скриншоты по расписанию, находите значимые визуальные изменения и получайте уведомления удобным способом.

Мониторы

Мониторы создаются в кабинете. FREE включает до 3, PAID — до 20 активных мониторов. Расписание хранится с часовым поясом IANA и корректно учитывает переходы летнего времени.

Письма об ошибках включены по умолчанию. Письма об успешных запусках должны быть разрешены и в самом мониторе, и в настройках аккаунта.

Visual diff

Для PNG-монитора можно включить сравнение с baseline и задать порог изменения от 0.1% до 100%. Первый успешный запуск становится baseline автоматически. Следующие запуски показывают процент изменения и diff-маску; уведомление об изменении создаётся только при превышении порога.

Любой успешный результат можно принять как новый baseline. Изменение параметров рендера сбрасывает прежний baseline, чтобы несопоставимые изображения не создавали ложные события.

Telegram

Подключите один Telegram-чат к аккаунту через одноразовую ссылку из кабинета. Ссылка действует 10 минут. Отдельно включайте уведомления об ошибках и изменениях мониторов, успешных запусках и завершении пакетов.

Webhooks

Сначала сохраните HTTPS endpoint в кабинете. Затем включайте доставку отдельно для нужных асинхронных запросов:

json
{
  "webhook": true,
  "externalId": "invoice-2026-071",
  "url": "https://example.com"
}

Shotly отправляет события screenshot.done и screenshot.error. При временной ошибке доставка повторяется с ограниченным backoff; историю и ручной повтор можно открыть в кабинете.

Проверка подписи

Подписываемая строка: X-Shotly-Timestamp + "." + rawBody. Вычислите HMAC-SHA256 сохранённым секретом и сравните hex-значение с X-Shotly-Signature после префикса v1= константным по времени сравнением. Отклоняйте устаревшие timestamps и сохраняйте X-Shotly-Event-Id для дедупликации.