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 }

목차