API 레퍼런스

인증

로그인, 회원가입, 인증 토큰 관리를 위한 엔드포인트. 모든 엔드포인트는 /v1.

기본 URL

text

https://api.authon.dev

인가

bash

# Client requests — use publishable key
Authorization: Bearer pk_live_your_publishable_key

# Server requests — use secret key
Authorization: Bearer sk_live_your_secret_key

POST/v1/auth/signin

이메일로 로그인

이메일과 비밀번호로 사용자를 인증합니다. 액세스 토큰과 리프레시 토큰을 반환합니다.

요청 본문

json

{
  "projectId": "proj_abc123",
  "email": "user@example.com",
  "password": "securepassword"
}

응답

json

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

POST/v1/auth/signup

이메일로 회원가입

새 사용자를 등록합니다. 성공 시 토큰을 반환하거나 이메일 인증 흐름을 시작합니다.

요청 본문

json

{
  "projectId": "proj_abc123",
  "email": "user@example.com",
  "password": "securepassword",
  "displayName": "John Doe"
}

응답

json

{
  "status": "verification_required",
  "message": "Check your email for a verification code"
}

POST/v1/auth/verify-email

이메일 인증

회원가입 후 전송된 6자리 OTP 코드로 이메일 주소를 인증합니다.

요청 본문

json

{
  "projectId": "proj_abc123",
  "email": "user@example.com",
  "code": "123456"
}

응답

json

{
  "accessToken": "eyJhbGci...",
  "refreshToken": "rt_abc123...",
  "expiresIn": 3600,
  "user": { ... }
}

POST/v1/auth/refresh

토큰 갱신

만료 전에 리프레시 토큰을 새 액세스 토큰으로 교환합니다.

요청 본문

json

{
  "refreshToken": "rt_abc123..."
}

응답

json

{
  "accessToken": "eyJhbGci...",
  "expiresIn": 3600
}

POST/v1/auth/signout

로그아웃

현재 세션을 무효화하고 리프레시 토큰을 취소합니다.

응답

json

{ "success": true }