ПлатформаИнтеграции и API

Встраивайте Broux в свой рабочий процесс

Broux работает не в изоляции — а как часть вашего стека. API и Webhook позволяют получать данные об ошибках и сессиях в любую систему, автоматизировать создание задач и строить собственные интеграции без ограничений.

API и Webhook — на плане Рост и выше

API и Webhook — разные задачи, разные инструменты

REST API

Вы инициируете запрос

Используйте когда нужно получить данные из Broux по запросу — список ошибок, детали сессии, информацию о пользователе. Подходит для построения собственных дашбордов, интеграции с CI/CD, автоматических отчётов.

  • Получить список новых ошибок после деплоя
  • Найти все сессии конкретного пользователя
  • Получить детали ошибки по ID
Webhook

Broux инициирует запрос

Используйте когда нужно реагировать на события в реальном времени — Broux отправляет POST-запрос на ваш URL при наступлении события. Новая ошибка, всплеск, скрипт молчит — уведомление приходит мгновенно без необходимости опрашивать API.

  • Автоматически создавать задачу в Jira при новой ошибке
  • Отправлять данные в собственную систему мониторинга
  • Триггерить сборку в CI/CD при критичной ошибке
  • Интегрировать с Zapier или n8n для автоматизации

Полный доступ к данным Broux

Сессии
  • GET/api/v1/sessions
  • GET/api/v1/sessions/{id}
  • GET/api/v1/sessions/{id}/events
  • GET/api/v1/sessions/{id}/errors
Список сессий с фильтрацией, детали конкретной сессии, события и ошибки внутри
Ошибки
  • GET/api/v1/errors
  • GET/api/v1/errors/{id}
  • GET/api/v1/errors/{id}/sessions
  • PATCH/api/v1/errors/{id}/status
Список ошибок с группировкой, детали, затронутые сессии, изменение статуса
Пользователи
  • GET/api/v1/users
  • GET/api/v1/users/{id}
  • GET/api/v1/users/{id}/sessions
  • GET/api/v1/users/{id}/errors
Поиск пользователей, история сессий и ошибок конкретного пользователя

Подпишитесь на нужные события

Настройте URL вашего endpoint в настройках Broux — и выберите на какие события подписаться. При наступлении события Broux отправит POST-запрос с JSON-payload. Повторные попытки при недоступности endpoint — автоматически.

  • error.newПоявилась новая ошибка которой раньше не было
  • error.spikeИзвестная ошибка резко участилась
  • error.thresholdОшибка достигла порога влияния по пользователям
  • error.returnedРешённая ошибка появилась снова
  • script.silentСкрипт перестал получать данные

Как команды используют интеграции

Webhook · error.new

Автоматически создавать задачи при новых ошибках

Webhook на событие error.new → ваш сервер получает данные → создаёт задачу в Jira или YouTrack с описанием ошибки, stack trace и ссылкой на сессию. Разработчик открывает задачу — всё уже внутри. Никаких ручных действий.

API · CI/CD

Проверять продакшен после каждого деплоя

После деплоя CI/CD делает запрос к API Broux — получает список новых ошибок за последние 15 минут. Если критичных нет — деплой успешный. Если есть — пайплайн останавливается и команда получает уведомление. Автоматический gate качества без ручной проверки.

API · BI

Строить собственные дашборды

Получаете данные из Broux через API и загружаете в свой BI-инструмент — DataLens, Metabase, Grafana. Объединяете с данными из CRM, биллинга, других источников. Видите полную картину — не только ошибки но и их связь с оттоком, выручкой, конверсией.

Webhook · No-code

Подключить к Zapier или n8n без программирования

Webhook Broux подключается к Zapier или n8n за несколько минут без написания кода. Новая ошибка → карточка в Trello. Всплеск → сообщение в Telegram. Лимит сессий → задача на апгрейд. Любая автоматизация которую можно представить.

Безопасный доступ к данным

API-ключи

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

Верификация Webhook

Каждый запрос от Broux подписан HMAC-подписью. Проверяйте подпись на вашем сервере — гарантия что запрос пришёл именно от Broux а не от третьей стороны.

Rate limiting

API защищён от злоупотреблений — лимит запросов в минуту на ключ. При превышении — 429 с заголовком Retry-After. Webhook повторяет попытки при недоступности endpoint — с экспоненциальной задержкой.

Всё для быстрого старта

Полная документация API

OpenAPI-спецификация, примеры запросов на популярных языках — JavaScript, Python, PHP, Go. Интерактивный playground для тестирования прямо в браузере.

SDK и примеры

Готовые примеры интеграций для популярных сценариев — Jira, YouTrack, Zapier, n8n. Копируете и адаптируете под свой стек.

Помощь с интеграцией

Если что-то не получается — пишите в поддержку. Помогаем с настройкой интеграций и отвечаем на технические вопросы.

Встройте Broux в свой стек

API и Webhook доступны на плане Рост и выше. Начните с бесплатного плана — и подключите интеграции когда будете готовы.