Skip to content

Auth API Spec

wcorn edited this page Apr 5, 2026 · 1 revision

API 설계: 인증 모듈

Base URL: /api/auth

1. 엔드포인트 목록

Method Path 설명 인증
POST /api/auth/login 로그인 불필요
POST /api/auth/reissue 토큰 갱신 불필요 (Cookie)
POST /api/auth/logout 로그아웃 불필요 (Cookie)

2. API 상세

POST /api/auth/login

로그인 후 Access Token과 Refresh Token을 발급한다.

Request

{
  "loginId": "dongseok",
  "password": "password123"
}

Response 200

{
  "code": "요청에 성공하였습니다.",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs..."
  }
}
Set-Cookie: refreshToken=eyJhbGciOi...; HttpOnly; Secure; SameSite=Strict; Path=/api/auth; Max-Age=1209600

Response 401

{
  "code": "AUTH-ERR-001",
  "message": "아이디 또는 비밀번호가 올바르지 않습니다."
}

POST /api/auth/reissue

Refresh Token으로 새 Access Token과 Refresh Token을 발급한다 (Rotation).

Request

Cookie: refreshToken=eyJhbGciOi...

Response 200

{
  "code": "요청에 성공하였습니다.",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs..."
  }
}
Set-Cookie: refreshToken=eyJhbGciOi...(새 토큰); HttpOnly; Secure; SameSite=Strict; Path=/api/auth; Max-Age=1209600

Response 401

{
  "code": "AUTH-ERR-002",
  "message": "유효하지 않은 토큰입니다."
}

POST /api/auth/logout

Refresh Token을 삭제하고 쿠키를 제거한다.

Request

Cookie: refreshToken=eyJhbGciOi...

Response 200

{
  "code": "요청에 성공하였습니다.",
  "data": null
}
Set-Cookie: refreshToken=; HttpOnly; Secure; SameSite=Strict; Path=/api/auth; Max-Age=0

3. 에러 코드

코드 HTTP 상태 메시지
AUTH-ERR-001 401 아이디 또는 비밀번호가 올바르지 않습니다
AUTH-ERR-002 401 유효하지 않은 토큰입니다

4. 공통 헤더

인증이 필요한 API 요청 시:

Authorization: Bearer {accessToken}

Clone this wiki locally