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

Кроме готовых интеграций, 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 (см. Действия).

Что дальше