Джерела і ключі

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

Що далі