開始 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 }