모든 API는 아래 형식으로 응답
성공 시
{
"result": "SUCCESS",
"data": { ... },
"message": "요청이 성공적으로 처리되었습니다.",
"status": 200
}
실패 시
{
"domain": "USER",
"code": "USER_001",
"message": "사용자를 찾을 수 없습니다.",
"status": 404
}
주요 에러 코드
| 코드 | 상태 | 설명 |
|---|---|---|
| AUTHENTICATION_FAILED | 401 | 인증 실패 |
| TOKEN_EXPIRED | 401 | 토큰 만료 |
| ACCESS_DENIED | 403 | 권한 없음 |
| USER_NOT_FOUND | 404 | 사용자 없음 |
| USER_ALREADY_EXISTS | 409 | 중복 사용자 |
| BOARD_NOT_FOUND | 404 | 게시글 없음 |
| BOARD_UNAUTHORIZED | 403 | 게시글 권한 없음 |
| COMMENT_NOT_FOUND | 404 | 댓글 없음 |
| FILE_NOT_FOUND | 404 | 파일 없음 |
| INVALID_FILE_TYPE | 400 | 잘못된 파일 형식 |
| FILE_SIZE_EXCEEDED | 400 | 파일 크기 초과 (최대 10MB) |
| CHAT_ROOM_NOT_FOUND | 404 | 채팅방 없음 |
| CHAT_BLOCKED | 400 | 차단된 사용자 |
| REPORT_ALREADY_EXISTS | 409 | 이미 신고함 |
| INTERNAL_SERVER_ERROR | 500 | 서버 오류 |
인증 방식
JWT 토큰을 Authorization: Bearer {token} 헤더 또는 jwtToken 쿠키로 전달
인증이 필요 없는 API는 각 항목에 표기했습니다.
역할 종류: USER, MANAGER, ADMIN