Źródła i klucze

Poza gotowymi integracjami, GetMyBot obsługuje dowolne HTTP API przez konektory (sekcja Źródła) i poświadczenia (sekcja Klucze). Konektor opisuje, dokąd się łączyć, klucz — jak się autoryzować. Używają ich akcje Zapytanie do źródła i Zapis do źródła.

Konektory (Źródła)

Sekcja Źródła → Konektory. Konektor posiada Nazwę, Typ, Bazowy URL, powiązane poświadczenia i nagłówki:

  • REST — dowolne HTTP/JSON API.
  • OzmaDB — instancja OzmaDB/FunDB; w bazowym URL podaje się korzeń REST API instancji, a zapytania do anonimowych widoków są uproszczone.
  • IMAP — oznaczony jako „wkrótce".

Przycisk Sprawdź wykonuje testowe żądanie i wyświetla status oraz opóźnienie (lub błąd) — wygodny sposób, aby upewnić się, że URL i klucz są poprawne.

Poświadczenia (Klucze)

Sekcja Klucze → Poświadczenia. Sekrety przechowywane są w postaci zaszyfrowanej. Typy:

  • Klucz API — klucz + nazwa nagłówka (domyślnie Authorization).
  • Token Bearer — token w nagłówku Authorization: Bearer.
  • OAuth2 (password) — Token URL, Client ID/Secret, login, hasło, zakres.
  • OAuth2 (refresh) — Token URL, Client ID/Secret, token odświeżania, zakres.

Dla OAuth2 platforma sama pobiera i buforuje tokeny, odnawiając je po wygaśnięciu i po odpowiedzi 401; rotacja tokenu odświeżania jest zapisywana. Podczas edycji puste pole sekretu oznacza „nie zmieniaj".

Odczyt i zapis z reakcji

  • Zapytanie do źródła (ds_query) — odczytuje dane przez konektor do ctx: podaje się ścieżkę, JSONPath do tablicy i klucz ctx dla wyniku. Następnie tablica jest iterowana pętlą po liście.
  • Zapis do źródła (ds_write) — wysyła dane (POST/PUT/DELETE) z ciałem w formacie JSON.

Dla jednorazowych żądań bez zapisanego konektora dostępna jest akcja Żądanie HTTP, a do pobierania tekstu strony — Wczytaj URL (zob. Akcje).

Co dalej