MINARA

Gmail OAuth 接続を開始

POST /v1/gateway/providers/:id/oauth/init:OAuth 形式のメッセージングプロバイダー向けに Google OAuth 同意フローを開始します。

POST /v1/gateway/providers/:id/oauth/init

OAuth 形式のメッセージングプロバイダー(email-gmail)向けに Google OAuth 同意フローを開始します。ゲートウェイはループバックコールバックをバインドし、ブラウザで開く Google の authorizeUrl を返します。その後、コールバックでコードを交換して接続を永続化します(GMAIL_REFRESH_TOKEN + GMAIL_SENDER_EMAIL)。Web UI は完了まで GET /v1/auth/oauth/flows/:state をポーリングします。運用者の Google client id/secret が未設定の場合は 400 google_client_not_configured、OAuth 以外のプロバイダーの場合は 404 provider_not_oauth、コールバックポートが使用中の場合は 409 port_in_use を返します。

メソッドPOST
パス/v1/gateway/providers/:id/oauth/init
認証GATEWAY_AUTH_TOKEN が設定されている場合は Authorization: Bearer <token> が必要
カテゴリgateway

レスポンス本文

{ "authorizeUrl": "https://accounts.google.com/o/oauth2/v2/auth?...", "state": "...", "flowId": "...", "redirectUri": "http://127.0.0.1:1457/callback", "expiresAt": 1730000000000 }

目次