Quellen und Schlüssel

Neben fertigen Integrationen kann GetMyBot über Konnektoren (Abschnitt Quellen) und Zugangsdaten (Abschnitt Schlüssel) mit beliebigen HTTP-APIs arbeiten. Ein Konnektor beschreibt, wohin Anfragen gehen, ein Schlüssel beschreibt, wie die Authentifizierung erfolgt. Sie werden von den Aktionen Quellanfrage und In Quelle schreiben verwendet.

Konnektoren (Quellen)

Abschnitt QuellenKonnektoren. Ein Konnektor hat Name, Typ, Basis-URL, zugeordnete Zugangsdaten und Header:

  • REST — beliebige HTTP/JSON-API.
  • OzmaDB — OzmaDB/FunDB-Instanz; die Basis-URL zeigt auf die REST-API-Wurzel der Instanz, Anfragen an anonyme Views werden vereinfacht.
  • IMAP — als „demnächst" markiert.

Die Schaltfläche Prüfen führt eine Testanfrage durch und zeigt Status und Latenz (oder Fehler) — praktisch, um zu prüfen, ob URL und Schlüssel korrekt sind.

Zugangsdaten (Schlüssel)

Abschnitt SchlüsselZugangsdaten. Geheimnisse werden verschlüsselt gespeichert. Typen:

  • API-Schlüssel — Schlüssel + Header-Name (Standard: Authorization).
  • Bearer-Token — Token im Header Authorization: Bearer.
  • OAuth2 (password) — Token-URL, Client-ID/Secret, Login, Passwort, Scope.
  • OAuth2 (refresh) — Token-URL, Client-ID/Secret, Refresh-Token, Scope.

Bei OAuth2 holt die Plattform selbstständig Tokens und cached sie, aktualisiert sie beim Ablauf und bei 401-Antworten; Refresh-Token-Rotation wird gespeichert. Beim Bearbeiten bedeutet ein leeres Geheimnis-Feld „nicht ändern".

Daten lesen und schreiben aus Reaktionen

  • Quellanfrage (ds_query) — liest Daten über den Konnektor in ctx: Pfad, JSONPath zum Array und ctx-Schlüssel für das Ergebnis werden angegeben. Das Array wird dann mit einer Schleife über eine Liste durchlaufen.
  • In Quelle schreiben (ds_write) — sendet Daten (POST/PUT/DELETE) mit einem Body im JSON-Format.

Für einzelne Anfragen ohne gespeicherten Konnektor gibt es die Aktion Web-Anfrage, und zum Herunterladen von Seitentext die Aktion URL laden (siehe Aktionen).

Nächste Schritte