Repository navigation
Auth API Spec
wcorn edited this page Apr 5, 2026
·
1 revision
Base URL: /api/auth
| Method | Path | 설명 | 인증 |
|---|---|---|---|
| POST | /api/auth/login |
로그인 | 불필요 |
| POST | /api/auth/reissue |
토큰 갱신 | 불필요 (Cookie) |
| POST | /api/auth/logout |
로그아웃 | 불필요 (Cookie) |
로그인 후 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": "아이디 또는 비밀번호가 올바르지 않습니다."
}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": "유효하지 않은 토큰입니다."
}Refresh Token을 삭제하고 쿠키를 제거한다.
Request
Cookie: refreshToken=eyJhbGciOi...
Response 200
{
"code": "요청에 성공하였습니다.",
"data": null
}Set-Cookie: refreshToken=; HttpOnly; Secure; SameSite=Strict; Path=/api/auth; Max-Age=0
| 코드 | HTTP 상태 | 메시지 |
|---|---|---|
| AUTH-ERR-001 | 401 | 아이디 또는 비밀번호가 올바르지 않습니다 |
| AUTH-ERR-002 | 401 | 유효하지 않은 토큰입니다 |
인증이 필요한 API 요청 시:
Authorization: Bearer {accessToken}