Auth API

📘 Auth API (Minimal Spec - v1)

1. 회원가입

POST /api/v1/auth/signup

새 사용자를 회원가입 처리합니다.

---

📥 Request

Body

{
  "email": "[email protected]",
  "password": "P@ssw0rd!",
  "nickName": "Beemo",
  "phoneNumber": "010-1234-5678"
}

---

📤 Response (201 Created)

{
  "id": 1,
  "email": "[email protected]",
  "nickName": "Beemo",
  "phoneNumber": "010-1234-5678",
  "createdAt": "2025-01-30T12:00:00"
}

비밀번호는 응답에 포함하지 않습니다.

---

2. 로그인

POST /api/v1/auth/login

이메일과 비밀번호로 로그인하고 JWT 토큰을 발급받습니다.

---

📥 Request

Body

{
  "email": "[email protected]",
  "password": "P@ssw0rd!"
}

---

📤 Response (200 OK)

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "tokenType": "Bearer",
  "expiresIn": 3600, //1시간
  "user": {...}
}

Set-Cookie: refreshToken={value}; Max-Age=604800; Expires=Sun, 14 Dec YYYY HH:MM:SS GMT; Path=/; Secure; HttpOnly; SameSite=Strict

• refreshToken의 경우 HttpOnly Cookie로 변경되었습니다.

• accessToken : 이후 요청 시 Authorization: Bearer {accessToken} 헤더에 넣어 사용

• tokenType : 보통 "Bearer" 고정

• expiresIn : access token 만료 시간(초 단위, 변경 가능)

• user : 로그인한 사용자 기본 정보

---

3. 로그아웃

POST /api/v1/auth/logout

현재 로그인된 사용자의 Refresh Token을 무효화하고, 세션을 종료합니다.

---

📥 Request

Cookie

• refreshToken

---

📤 Response (204 No Content)

---

4. 액세스 토큰 재발급

POST /api/v1/auth/refresh

리프레시 토큰 인증을 통해 엑세스 토큰 재발급합니다.

---

📥 Request

Cookie

• refreshToken

---

📤 Response (200 OK)

{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9....",
  "tokenType": "Bearer",
  "expiresIn": 3600,
  "expiresAt": "2025-12-07T20:55:10.113808"
}

---

📚 참고 문서

• 공통 예외 응답 형식
• 에러 코드 전체 보기