Что это
Metabase API - программный доступ к вашему экземпляру Metabase. Например, приложение может получить список сохраненных вопросов и построить реестр отчетов с их идентификаторами и названиями. Для такого запроса языковая модель не нужна.
API-ключ связывается с группой и получает ее разрешения. Поэтому интеграции следует выдавать только необходимые права, а не использовать ключ администратора для любого отчета. Внешний AI-агент может обращаться к API через ваш код, но выбор действий и проверка результата не появляются автоматически.
У API нет версионирования: обновление Metabase может изменить контракт. Сверяйте запросы с документацией установленного экземпляра и проверяйте интеграцию перед обновлением. Бесплатная Open Source Edition не отменяет расходы на сервер и сопровождение.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Да
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Доступ к вопросам, дашбордам и коллекциям позволяет автоматизировать работу с отчетами.
- Ключи привязаны к группам, что позволяет отделить права разных интеграций.
- Обычные HTTP-запросы можно вызывать из серверного кода или системы автоматизации.
- Запросы можно проверять на своем экземпляре Metabase, не публикуя отчеты по открытой ссылке.
Ограничения
- Неверсионируемый API требует проверки совместимости после обновлений.
- Права группы ограничивают доступные объекты; ключ администратора создает избыточный доступ.
- Ключ - секрет: его нельзя помещать в браузерный код, промпт или открытый репозиторий.
- API не определяет бизнес-метрики и не проверяет смысл отчета вместо аналитика.
Как использовать
1. Подготовка. Откройте учебный Metabase, создайте сохраненный вопрос и проверьте, что отдельная группа интеграции видит только нужную коллекцию. Найдите документацию API своего экземпляра по пути /api/docs.
2. Настройка. Администратор создает ключ в Admin Settings > Authentication > API Keys и назначает группу. Сохраните ключ как серверный секрет: он показывается при создании. Подготовьте GET-запрос к https://ВАШ_METABASE/api/card с заголовком X-API-Key; пример адреса замените своим.
3. Первый результат. Отправьте запрос из серверного HTTP-клиента и получите список доступных сохраненных вопросов. Сохраните идентификатор и название учебного вопроса в реестр отчетов. Изменение объектов и публичные ссылки для этого теста не нужны.
4. Проверка. Сопоставьте реестр с интерфейсом пользователя этой группы: закрытые вопросы не должны появиться. Проверьте отказ при неправильном ключе и отсутствие ключа в логах. Сохраните этот тест и повторяйте его после обновления Metabase.
Доступ и оплата
- Модель оплаты: Open-source
- Бесплатный тариф: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
API работает у существующего Metabase: нужен доступ к экземпляру и разрешение на создание ключа. Условия облачного или коммерческого размещения не заменяются бесплатностью OSS-редакции.
Когда не подходит
- Создать агента одним API-ключом
- Обойти разрешения на данные
- Использовать один контракт API без проверки обновлений
Альтернативы
Интерфейс Metabase подходит для ручной настройки отчета. Looker API и Power BI REST API применяются в соответствующих BI-системах; их права и контракты отличаются, поэтому заменить адрес сервера недостаточно.
