GetMyBot ナレッジベース

ソースとキー

REST/OzmaDB コネクター、認証情報、リアクションからのデータ読み書き。

このページの内容

既成の連携に加えて、GetMyBot は コネクター(ソース セクション)と 認証情報(キー セクション)を通じて任意の HTTP API を操作できます。コネクターはどこにアクセスするかを定義し、キーはどのように認証するかを定義します。これらは ソースへのリクエスト と ソースへの書き込み アクションで使用されます。

コネクター(ソース)

ソース → コネクター セクション。コネクターには 名前、タイプ、ベース URL、紐付けられた認証情報、ヘッダー があります:

  • REST — 任意の HTTP/JSON API。
  • OzmaDB — OzmaDB/FunDB インスタンス。ベース URL には REST API インスタンスのルートを指定し、匿名ビューへのリクエストが簡略化されます。
  • IMAP — 「近日公開」とマークされています。

テスト ボタンでテストリクエストを実行し、ステータスとレイテンシ(またはエラー)を確認できます。URL とキーが正しいか確認するのに便利です。

認証情報(キー)

キー → 認証情報 セクション。シークレットは暗号化して保存されます。タイプ:

  • API キー — キーとヘッダー名(デフォルトは Authorization)。
  • Bearer トークン — Authorization: Bearer ヘッダーのトークン。
  • OAuth2 (password) — Token URL、Client ID/Secret、ログイン、パスワード、スコープ。
  • OAuth2 (refresh) — Token URL、Client ID/Secret、リフレッシュトークン、スコープ。

OAuth2 の場合、プラットフォームが自動的にトークンを取得してキャッシュし、期限切れや 401 レスポンス時に更新します。リフレッシュトークンのローテーションも保存されます。編集時にシークレットフィールドを空にすると「変更しない」を意味します。

リアクションからのデータ読み書き

  • ソースへのリクエスト(ds_query)— コネクターを介してデータを ctx に読み込みます。パス、配列への JSONPath、結果の ctx キーを指定します。その後、配列はリストのループで反復できます。
  • ソースへの書き込み(ds_write)— JSON 形式のボディでデータを送信します(POST/PUT/DELETE)。

保存済みコネクターなしの単発リクエストには ウェブリクエスト アクション、ページのテキストをダウンロードするには URL を読み込む アクションを使用します(アクション を参照)。

次のステップ