7.3 Специальные плагины

Командой разработчиков Bubble были созданы несколько плагинов для того, чтобы вы могли добавить соединение с внешними службами (или закрытыми бэкэндами).

Коннектор API

Коннектор API это специальный плагин, разработанный Bubble для того, чтобы вы могли связаться с любым сервисом, который поддерживает основанный на JSON REST-подобный веб API. Вы можете добавить вызовы по API для получения данных из сторонних сервисов либо отправлять POST запросы для того, чтобы запускать какие-то действия на стороне сервиса.Коннектор API имеет тот же интерфейс и бэкэнд, что и конструктор Плагинов для вызовов по API, глава Создание Плагинов (!!!ЛНК!!!) описывает этот интерфейс в более подробном виде (!!!ЛНК!!!). Важно отметить, что так как соединение с вашим приложением создается с помощью API коннектора, оно может быть преобразовано в плагин правым кликом мыши по API коннектору и созданием плагина. Пожалуйста, преобразуйте как можно больше открытых API в плагины, так как тем самым вы поделитесь функционалом с другими пользователями Баббл.

Коннектор приложений Bubble

Коннектор приложений позволяет связать два приложения Bubble и получить доступ к API и данным одного приложения в другом. Таким образом, вы сможете зарегистрироваться через OAuth в другом приложении, запускать процессы от имени пользователя второго приложения и т.д.

Для использования коннектора приложений вам нужно настроить API в приложении A перед тем, как использовать его в приложении B. Если вы хотите, чтобы пользователи приложения B регистрировались с помощью приложения A, вам нужно задать учетные данные OAuth в приложении A во вкладке "Настройки" (см. этот раздел (!!!ЛНК!!!) для получения подробностей). Когда это будет сделано, вы сможете установить Коннектор Приложений Bubble в приложении В и добавить приложение А. После добавления приложения, Bubble автоматически подтянет различные открытые вызовы и процессы, которые предоставляет приложение А. Вы сможете установить различные вызовы и использовать их как источники данных в "Получить данные по API"/"Get data from API" или действиях в ваших процессах.

У вас есть несколько вариантов авторизации для запуска вызовов. Авторизация важна, так как личность пользователя, совершающего вызовы может влиять на видимость данных в зависимости от роли конфиденциальности в приложении А. По умолчанию, вы можете либо выбрать ключ API, либо не предоставлять данные авторизации (тогда вызовы исполнятся так, как задано в приложении А). Если вы введете ID и Пароль клиента, то вы также сможете разрешить пользователям авторизовываться в приложении В с данными приложения А через OAuth, и OAuth - третий вариант авторизации.

1. Без авторизации: вызовы будут работать без ключа API и будут запускаться от имени пользователя, не вошедшего в систему

2. API ключ: вызовы будут осуществляться от имени администратора приложения А, со всеми правами доступа.

3. OAuth: вызовы будут осуществляться на стороне пользователя, который вошел в приложение В с помощью А, и роли конфиденциальности к нему/к ней будут применяться как к текущему пользователю.

Коннектор базы данных SQL

Коннектор базы данных позволяет вам связаться с базой данных и запускать SQL запросы из Bubble. Эти запросы могут быть запущены как действия, источники данных (они отобразятся во Внешних API) или обоими способами. Bubble поддерживает соединение с PostGres, MySQL и Microsoft SQL.

Для использования этого плагина вам сперва нужно указать строку соединения, которая представляет базу данных, с которой вы хотите связаться.

Соединение должно выглядеть как:

mssql://username:[e-mail]:PORT/db_name

Если необходимо зашифровать соединение (например, с помощью Microsoft Azure), вам нужно к соединению добавить

?encrypt=true

После создания строки соединения и её проверки, вы можете создавать запросы и запускать их. Допустимо любое SQL выражение, но для выражений SELECT вам нужно в конце добавлять LIMIT N, где N <= 100. После тестирования и сохранения запроса вы можете использовать его как действие, источник данных или обоими способами, в зависимости от того, как вы его написали. Обратите внимание, что SELECT возвращает список сущностей.