API 명세서


Request Header

Content-Type: application/json
Authorization: Bearer {token} // 비인가/비인증 API 호출 시 생략

Logs

행동 로그 유형 추천 상품 상태
view 가입
관심 관심
조회 회고

JWT

Payload
유저 이메일
토큰 발급 시간
토큰 만료 시간

ProductId Prefix

예금 Deposit D
적금 Savings S
공격형 연금 Aggressive Pension A
안정형 연금 Conservative Pension C
펀드 Fund F
외화 Foreign eXchange X

Global Error Code

Category Code Message HTTP Status
Common C001 잘못된 입력값입니다. 400 BAD_REQUEST
C002 허용되지 않은 HTTP 메서드입니다. 405 METHOD_NOT_ALLOWED
C003 요청한 데이터를 찾을 수 없습니다. 404 NOT_FOUND
C004 서버 내부 오류가 발생했습니다. 500 INTERNAL_SERVER_ERROR
C005 잘못된 타입입니다. 400 BAD_REQUEST
C006 접근이 거부되었습니다. 403 FORBIDDEN
Authentication & Authorization A001 인증에 실패했습니다. 401 UNAUTHORIZED
A002 권한이 없습니다. 403 FORBIDDEN
A003 유효하지 않은 JWT 토큰입니다. 401 UNAUTHORIZED
A004 만료된 JWT 토큰입니다. 401 UNAUTHORIZED
User U001 사용자를 찾을 수 없습니다. 404 NOT_FOUND
U002 이미 존재하는 사용자입니다. 409 CONFLICT
U003 비밀번호가 일치하지 않습니다. 400 BAD_REQUEST
Product P001 상품을 찾을 수 없습니다. 404 NOT_FOUND
P002 상품 분석에 실패했습니다. 500 INTERNAL_SERVER_ERROR
External API E001 외부 API 호출 중 오류가 발생했습니다. 503 SERVICE_UNAVAILABLE
Database D001 데이터베이스 오류가 발생했습니다. 500 INTERNAL_SERVER_ERROR
Validation V001 유효성 검사에 실패했습니다. 400 BAD_REQUEST

<aside>

외부 API, Datasets