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 }

本页目录