Skip to main content

​
SDK и интеграция

Проверьте по шагам:
  1. Правильный ли projectKey? Скопируйте его заново из Настройки проекта → API Key.
  2. init() вызывается до ошибки? Убедитесь, что инициализация происходит в самом начале точки входа (main.js, _app.tsx).
  3. Откройте вкладку Network в DevTools → отфильтруйте по /api/v1/errors → найдите POST-запрос.
    • Если запроса нет — SDK не инициализирован или ошибка происходит до вызова init().
    • Если запрос есть и возвращает 200 — проверьте, правильный ли проект открыт в дашборде.
    • Если 401 — неверный ключ.
    • Если 429 — исчерпан лимит ошибок плана.
  4. Проверьте консоль на предупреждения [MakboolSDK].
В консоли: Access to fetch at 'https://makbool.ru/api/v1/errors' has been blocked by CORS policyНапишите нам на support@makbool.ru — добавим ваш домен в список разрешённых.
Текущий JS SDK предназначен только для браузера — он использует window.onerror и fetch.Для Node.js и React Native используйте Python SDK или отправляйте ошибки напрямую через REST API.
SDK имеет встроенный rate limit. Если сервер отвечает 429 (лимит плана исчерпан), SDK прекращает отправку до перезагрузки страницы.Проверьте текущее использование в Биллинг → Использование.

​
AI-объяснения

Возможные причины:
  1. Исчерпан лимит AI-объяснений — проверьте в Биллинг → Использование.
  2. AI-объяснение генерируется асинхронно — обновите страницу через 10-15 секунд.
Если проблема не решается — напишите на support@makbool.ru.

​
Дашборд

Дашборд использует SSE для обновлений. Проверьте:
  1. Откройте DevTools → Network → отфильтруйте по stream — должно быть активное EventSource соединение.
  2. SSE не работает через HTTP/1.0 прокси. Убедитесь, что у вас HTTPS и HTTP/1.1 или HTTP/2.
  3. Попробуйте обновить страницу.
Загрузите source maps через Настройки проекта → Source Maps или через API:
curl -X POST https://makbool.ru/api/v1/projects/{id}/source-maps \
  -H "Authorization: Bearer <token>" \
  -F "file=@dist/assets/index.abc123.js.map"
Source maps загружаются один раз на релиз. Автоматизируйте загрузку в CI/CD после каждого билда.
Это ожидаемое поведение. Если та же ошибка (по fingerprint) поступает снова, она автоматически возвращается в active — чтобы вы не пропустили регрессию.

​
Биллинг

Активация происходит через webhook от ЮКасса — обычно за несколько секунд.Если план не обновился через 5 минут — напишите нам на support@makbool.ru с номером платежа из письма от ЮКасса.
Напишите на support@makbool.ru с ИНН организации — выставим счёт.

​
Нашли баг?

Если что-то работает не так — напишите нам: