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 }