Main API토큰 API
토큰 API 개요
Access Token 갱신 및 인증 관리 API
토큰 API
Access Token 갱신 및 인증 관련 API입니다.
Base URL: /auth
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 부분적 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /auth/refreshToken | Access Token 재발급 | Refresh Token |
GET | /auth/check-authority | 권한 확인 | 필요 |
토큰 유효기간
| 토큰 종류 | 유효 기간 |
|---|---|
| Access Token | 14일 |
| Refresh Token | 14일 |
토큰 갱신 플로우
API 요청 시 401 응답 수신
Access Token이 만료되면 서버에서 401 Unauthorized 응답을 반환합니다.
Refresh Token으로 갱신 요청
저장된 Refresh Token을 사용하여 /auth/refreshToken API를 호출합니다.
새 토큰 수신
새로운 Access Token과 Refresh Token을 응답으로 받습니다.
토큰 저장소 업데이트
앱의 토큰 저장소에 새 토큰들을 저장합니다.
원래 요청 재시도
새 Access Token으로 처음 실패했던 API 요청을 다시 시도합니다.