Интеграция с API

Fast BI позволяет получать данные из внешних сервисов двумя способами: через готовый коннектор или по ссылке, которая возвращает JSON. Выберите коннектор, если ваш сервис есть в списке интеграций. Для собственного API подойдёт загрузка по ссылке, если он отдаёт нужные записи одним GET-запросом.

Подключите готовый сервис

В списке есть Bitrix24, amoCRM, Ozon Seller, Wildberries, Weeek, ALAN IoT App и Business Scanner (Задачи). Параметры доступа зависят от сервиса: например, Ozon требует Client ID и API Key, а Bitrix24 — адрес входящего вебхука.

1. Откройте Подключения и нажмите Создать новое подключение. На узком экране кнопка называется Создать.
2. Выберите Интеграции, нажмите Далее, выберите сервис и снова нажмите Далее.
3. Укажите название и заполните параметры доступа. Если форма предлагает проверку, выполните её до сохранения.
4. Нажмите Сохранить. Для подключения amoCRM через OAuth кнопка называется Подключить.
5. Откройте отчёт в режиме редактирования, нажмите Получить данные и выберите Коннекторы.
6. Выберите созданное подключение и нажмите Далее. На следующем шаге выберите доступные таблицы, сущности или устройство — набор зависит от сервиса.

Для обычной загрузки таблиц нажмите Загрузить и преобразовать. У CRM могут быть дополнительные настройки модели и стартовых страниц; подпись кнопки меняется в зависимости от выбранного варианта. После успешной загрузки вернитесь к отчёту и проверьте новые источники в панели Данные.

Получите JSON по ссылке

Подготовьте URL запроса и, если нужны, HTTP-заголовки для доступа. Ответ должен содержать массив записей или объект, который можно представить таблицей.

1. В отчёте нажмите Получить данные и выберите Ссылки.
2. Заполните URL. При желании укажите Название источника.
3. Если API требует авторизацию, нажмите + Добавить заголовок и задайте его имя и значение. Поддерживаются, например, Authorization и X-API-Key.
4. Нажмите Загрузить данные.
5. В предпросмотре выберите Путь к данным. Если записи находятся внутри data.items, выберите этот путь; для массива в корне ответа — (корень ответа).
6. Проверьте Типы колонок: текст, число или дата. Вложенный объект можно раскрыть через меню заголовка колонки Развернуть столбцы.
7. Нажмите Загрузить и преобразовать.

Окно закроется, а источник появится в отчёте. Разверните его в панели Данные и проверьте поля. Предпросмотр показывает до 100 записей; он помогает проверить структуру, но не подтверждает полноту выгрузки.

Проверьте, подходит ли ваш API

Сценарий Ссылки выполняет GET-запрос и читает JSON. В нём нет настройки POST-запроса, тела запроса или автоматического обхода страниц API. Если сервис выдаёт данные порциями, заранее подготовьте подходящую выгрузку или используйте готовый коннектор.

Предпросмотр запрашивает данные из браузера, поэтому API должен разрешать такие запросы с адреса Fast BI. Если браузер блокирует доступ, уточните настройки у администратора API. Раздел Веб-службы с пометкой Скоро пока не подключает источники.