ソースとキー

既成の連携に加えて、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 を読み込む アクションを使用します（アクション を参照）。

次のステップ