База знаний GetMyBot

Источники и ключи

Коннекторы REST/OzmaDB, учётные данные и чтение/запись данных из реакций.

На этой странице

Кроме готовых интеграций, GetMyBot умеет работать с произвольными HTTP-API через коннекторы (раздел Источники) и учётные данные (раздел Ключи). Коннектор задаёт адрес запроса, а ключ определяет способ авторизации. Их используют действия Запрос к источнику и Запись в источник.

Коннекторы (Источники)

Раздел Источники → Коннекторы. У коннектора есть Название, Тип, Базовый URL, привязанные учётные данные и заголовки:

  • REST: любой HTTP/JSON-API.
  • OzmaDB: инстанс OzmaDB/FunDB; в базовом URL указывается корень REST API инстанса, а запросы к анонимным view упрощены.
  • IMAP: размечен как «скоро».

Кнопка Проверить делает тестовый запрос и показывает статус и задержку (или ошибку): удобно убедиться, что URL и ключ верны.

Учётные данные (Ключи)

Раздел Ключи → Учётные данные. Секреты хранятся в зашифрованном виде. Типы:

  • API-ключ: ключ + имя заголовка (по умолчанию Authorization).
  • Bearer-токен: токен в заголовке Authorization: Bearer.
  • OAuth2 (password): Token URL, Client ID/Secret, логин, пароль, scope.
  • OAuth2 (refresh): Token URL, Client ID/Secret, refresh-токен, scope.

Для OAuth2 платформа сама получает и кеширует токены, обновляя их при истечении и по ответу 401; ротация refresh-токена сохраняется. При редактировании пустое поле секрета означает «не менять».

Чтение и запись из реакций

  • Запрос к источнику (ds_query): читает данные через коннектор в ctx: указываются путь, JSONPath к массиву и ключ ctx для результата. Дальше массив перебирается циклом по списку.
  • Запись в источник (ds_write): отправляет данные (POST/PUT/DELETE) с телом в формате JSON.

Для разовых запросов без сохранённого коннектора есть действие Веб-запрос, а для скачивания текста страницы: Загрузить URL (см. Действия).

Что дальше