API 레퍼런스

OAuth

서드파티 제공자 인증을 위한 OAuth 2.0 / PKCE 흐름 엔드포인트. SDK가 자동으로 처리합니다 — 이 엔드포인트는 직접 구현을 위해 문서화되어 있습니다.

지원 제공자

google

github

apple

kakao

naver

facebook

discord

slack

twitch

line

microsoft

OAuth 흐름

OAuth 시작

authorize 엔드포인트를 호출하여 PKCE 챌린지가 포함된 OAuth URL을 가져옵니다.

사용자 리디렉션

사용자를 OAuth 제공자의 인증 페이지로 리디렉션합니다.

콜백 처리

제공자가 코드와 함께 콜백 URL로 리디렉션합니다.

코드 교환

인증 코드를 Authon 액세스 및 리프레시 토큰으로 교환합니다.

GET/v1/oauth/:provider/authorize

인증 URL 가져오기

PKCE 챌린지가 포함된 OAuth 제공자 인증 URL을 가져옵니다. 사용자를 리디렉션할 URL을 반환합니다.

쿼리 파라미터

text

?projectId=proj_abc123&redirectUrl=https://yourapp.com/callback

응답

json

{
  "url": "https:0
  2: "random_state_value",
  "codeVerifier": "pkce_verifier"
}

POST/v1/oauth/:provider/callback

OAuth 콜백 처리

OAuth 인증 코드를 Authon 토큰으로 교환합니다.

요청 본문

json

{
  "code": "auth_code_from_provider",
  "state": "random_state_value",
  "codeVerifier": "pkce_verifier",
  "projectId": "proj_abc123"
}

응답

json

{
  "accessToken": "eyJhbGci...",
  "refreshToken": "rt_abc123...",
  "expiresIn": 3600,
  "user": {
    "id": "usr_abc123",
    "email": "user@example.com",
    "displayName": "John Doe"
  },
  "isNewUser": false
}