GetMyBot-Wissensdatenbank

Quellen und Schlüssel

REST/OzmaDB-Konnektoren, Zugangsdaten sowie Daten lesen und schreiben aus Reaktionen.

Auf dieser Seite

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 Quellen → Konnektoren. 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üssel → Zugangsdaten. 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