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