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 }

本頁目錄