Access Token 재발급

401 토큰 만료 에러 발생 시 Access Token 및 Refresh Token을 재발급합니다.

Authorization 헤더에 Refresh Token을 전달해야 합니다.

항목	값
메서드	`POST`
경로	`/ai/auth/refreshToken`
인증	Refresh Token

요청

POST /ai/auth/refreshToken
Authorization: Bearer {refresh_token}

요청 헤더

헤더	필수	설명
`Authorization`	예	Bearer {refresh_token} 형식

응답

성공 응답 (200 OK)

{
  "id": "user_id",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "isNewUser": false
}

Response 스키마 (TokenDto)

필드명	타입	설명
`id`	`string`	사용자 ID
`accessToken`	`string`	새로 발급된 Access Token
`refreshToken`	`string`	새로 발급된 Refresh Token
`isNewUser`	`boolean`	신규 사용자 여부

에러 응답 (401 Unauthorized)

토큰 갱신 실패 시 다음 형식으로 에러가 반환됩니다:

{
  "status": 401,
  "code": "ERROR_CODE",
  "message": "에러 메시지",
  "data": null
}

에러 코드

에러 코드	설명	프론트엔드 처리
`TOKEN_INVALID`	토큰 서명이 유효하지 않음 (위조되었거나 손상됨)	로그인 페이지로 이동
`REFRESH_TOKEN_EXPIRED`	Redis에 저장된 토큰이 없거나 불일치 (세션 만료)	"세션이 만료되었습니다" 메시지 표시 후 로그인 페이지로 이동

중요: 에러 발생 시 code 필드를 확인하여 적절한 처리를 해야 합니다. 무한 로딩을 방지하려면 401 에러 시 반드시 로그아웃 처리가 필요합니다.

POST /ai/auth/refreshToken